Editace metadat EPUB pomocí Javy

V minulém článku jsme diskutovali o správě metadat EPUB a Dublin Core pomocí C#. Dnes se naučíme, jak můžete pomocí Javy programově číst, upravovat a aktualizovat vlastnosti metadat EPUB, včetně sady vlastností Dublin Core.

Soubor EPUB je formát digitální knihy, který obsahuje text, obrázky a interaktivní prvky. Je vytvořen pomocí běžných webových technologií, jako jsou HTML a CSS.

Metadata EPUB znamenají důležité informace uložené v souborech EPUB, jako je název, autor, vydavatel a jazyk. Tato data pomáhají při správné organizaci digitálních knih.

Zde jsou témata, kterými se budeme zabývat:

Java API pro úpravu metadat

GroupDocs.Metadata nabízí Java API určené k automatizaci správy metadat pro různé formáty souborů v aplikacích Java. Toto rozhraní API umožňuje čtení, aktualizaci, přidávání, čištění a odstraňování metadat z různých typů souborů. V naší dnešní diskusi využijeme toto API ke zpracování metadat elektronických knih ve formátu EPUB.

Soubor JAR můžete získat z části ke stažení nebo začlenit nejnovější konfigurace úložiště a závislostí Maven do svých aplikací Java.

<repository>
    <id>GroupDocsJavaAPI</id>
    <name>GroupDocs Java API</name>
    <url>https://releases.groupdocs.com/java/repo/</url>
</repository>

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata</artifactId>
    <version>23.10</version>
</dependency>

Úprava metadat EPUB pomocí Javy

Chcete-li jako vývojář Java upravit vlastnosti metadat EPUB, postupujte takto:

  1. Načtěte elektronickou knihu EPUB pomocí třídy Metadata.
  2. K extrahování kořenového balíčku metadat použijte metodu getRootPackageGeneric.
  3. Nyní můžete snadno zobrazit všechny vlastnosti metadat balíčku EPUB pomocí příslušné metody getter.
  4. Aktualizujte hodnoty vlastností podle potřeby pomocí příslušné metody setter.
  5. Uložte soubor elektronické knihy s aktualizovanými hodnotami metadat pomocí metody uložení.

Níže jsou uvedeny úryvky kódu Java ilustrující kroky ke čtení a aktualizaci vlastností metadat EPUB:

Přečtěte si metadata EPUB

Pro začátek zde je návod, jak můžete číst metadata EPUB pomocí Java:

// Čtěte metadata EPUB pomocí Javy
try (Metadata metadata = new Metadata("path/ebook.epub")) {
    EpubRootPackage root = metadata.getRootPackageGeneric();

    System.out.println(root.getEpubPackage().getVersion());
    System.out.println(root.getEpubPackage().getUniqueIdentifier());
    System.out.println(root.getEpubPackage().getImageCover() != null ? root.getEpubPackage().getImageCover().length : 0);
}

Aktualizujte metadata EPUB

Následující zdrojový kód Java ukazuje, jak načíst a aktualizovat vlastnosti metadat EPUB souboru EPUB:

// Aktualizujte metadata EPUB pomocí Javy
try (Metadata metadata = new Metadata("path/ebook.epub")) {
    EpubRootPackage root = metadata.getRootPackageGeneric();

    root.getEpubPackage().setCreator("GroupDocs");
    root.getEpubPackage().setDescription("test e-book");
    root.getEpubPackage().setFormat("EPUB");
    root.getEpubPackage().setDate(new Date().toString());

    metadata.save("path/ebook.epub");
}

Úprava metadat EPUB Dublin Core pomocí Javy

Metadata Dublin Core se skládají z několika položek, které popisují fyzické i digitální zdroje. Vlastnosti metadat Dublin Core můžete upravit pomocí kódu Java podobným způsobem jako metadata EPUB.

Přečtěte si Dublin Core

Následující řádky kódu ukazují, jak extrahovat položky metadat Dublin Core pro analýzu:

// Čtěte metadata Dublin Core pomocí Javy
try (Metadata metadata = new Metadata("path/ebook.epub")) {
    EpubRootPackage root = metadata.getRootPackageGeneric();

    System.out.println(root.getDublinCorePackage().getRights());
    System.out.println(root.getDublinCorePackage().getPublisher());
    System.out.println(root.getDublinCorePackage().getTitle());
    System.out.println(root.getDublinCorePackage().getCreator());
    System.out.println(root.getDublinCorePackage().getLanguage());
    System.out.println(root.getDublinCorePackage().getDate());
}

Aktualizujte Dublin Core

Podle potřeby můžete změnit konkrétní vlastnosti Dublin Core, jak je znázorněno v kódu níže:

// Aktualizujte metadata Dublin Core pomocí Javy
try (Metadata metadata = new Metadata("path/ebook.epub")) {
    EpubRootPackage root = metadata.getRootPackageGeneric();

    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:creator"), new PropertyValue("GroupDocs"));
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:description"), new PropertyValue("test e-book"));
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:title"), new PropertyValue("test EPUB"));
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:date"), new PropertyValue(new Date().toString()));

    metadata.save("path/ebook.epub");
}

Získání bezplatné licence

Pokud chcete plně zažít možnosti tohoto API, můžete získat dočasnou licenci zdarma.

Závěr

V tomto článku jsme se podívali na manipulaci s metadaty EPUB. Zpočátku jsme zkoumali, jak číst a upravovat vlastnosti metadat EPUB programově pomocí Javy. Později jsme stejné techniky aplikovali na sadu položek Dublin Core v rámci elektronických knih.

Pro podrobné informace o rozhraní API se čtenářům doporučuje nahlédnout do:

Případné dotazy nebo další diskuse můžete směřovat na poskytnuté fórum.

Viz také