Upravit metadata EPUB

V rychle se vyvíjejícím digitálním prostředí si elektronické knihy (EPUBs) získaly obrovskou popularitu díky jejich pohodlí a dostupnosti. Správa metadat těchto e-knih je však často zásadním, ale přehlíženým aspektem. Metadata nesou základní informace o e-knize, jako je její název, autor, datum vydání a další. V tomto příspěvku na blogu prozkoumáme, jak využít sílu Java a GroupDocs.Metadata Cloud API ke snadné úpravě metadat e-knih EPUB pomocí REST API. Kromě toho poskytneme podrobné pokyny k nastavení sady GroupDocs.Metadata Cloud SDK pro Javu a ke změně vlastností metadat pomocí specifikovaných značek. Jako bonus také zavedeme online editor metadat EPUB pro vylepšení vaší zkušenosti se správou metadat.

V tomto článku se budeme zabývat následujícími body:

Nastavení prostředí

Předpoklady:

Než se pustíme do implementace, ujistěte se, že máte splněny následující předpoklady:

  • Nainstalovaná Java Development Kit (JDK).
  • GroupDocs účet pro získání přihlašovacích údajů API.
  • Základní znalost REST API a programování Java.

Získání přihlašovacích údajů API:

Chcete-li začít, zaregistrujte si cloudový účet GroupDocs a vytvořte aplikaci. dashboard vám poskytne potřebné přihlašovací údaje (App SID a App Key) k ověření vašich požadavků.

Přidání sady GroupDocs.Metadata Cloud SDK pro Java:

Chcete-li začlenit SDK do svého projektu Java, můžete si stáhnout soubor JAR API nebo jej nainstalovat pomocí Maven přidáním následujícího úložiště a závislosti do souboru pom.xml vašeho projektu:

Úložiště Maven:

<repository>
    <id>groupdocs-artifact-repository</id>
    <name>GroupDocs Artifact Repository</name>
    <url>https://repository.groupdocs.cloud/repo</url>
</repository>

Závislost na Mavenovi:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata-cloud</artifactId>
    <version>23.3</version>
    <scope>compile</scope>
</dependency>

Inicializace klienta API

Chcete-li nastavit klienta API, použijte prosím své ID klienta a Tajný klíč klienta v kódu uvedeném níže:

String clientId = "APP_SID";
String clientSecret = "APP_KEY";
String myStorage = "";
Configuration configuration = new Configuration(clientId, clientSecret);
view raw initialize-API-client.java hosted with ❤ by GitHub

Změna vlastností metadat EPUB

Načítání e-knihy EPUB:

Nejprve nahrajte e-knihu EPUB, kterou chcete upravit. Toho lze dosáhnout použitím libovolné z následujících metod k nahrání souborů do cloudového úložiště:

  • Nahrajte všechny soubory jeden po druhém pomocí Upload File API z prohlížeče.
  • Pomocí dashboard.
  • Nahrajte programově pomocí níže uvedeného příkladu kódu:
// api initialization
FileApi apiInstance = new FileApi(clientId, clientSecret);
// input file
File fileStream = new File("C:\\Files\\sample.epub");
// create file upload request
UploadFileRequest request = new UploadFileRequest("sample.epub", fileStream, myStorage);
// upload file
FilesUploadResult response = apiInstance.uploadFile(request);
view raw upload-file.java hosted with ❤ by GitHub

V důsledku toho budou nahrané soubory dostupné v sekce souborů vašeho řídicího panelu v cloudu.

Společné vlastnosti metadat EPUB:

Zde jsou některé běžné vlastnosti metadat nalezené v souborech EPUB:

  • Název: Název elektronické knihy.
  • Tvůrce: Autor nebo tvůrce elektronické knihy.
  • Jazyk: Jazyk obsahu elektronické knihy.
  • Vydavatel: Vydavatel e-knihy.
  • Popis: Stručný popis nebo shrnutí elektronické knihy.
  • Datum: Datum vydání nebo datum vytvoření e-knihy.
  • Předmět: Klíčová slova nebo fráze, které popisují obsah elektronické knihy.
  • Práva: Informace o právech a oprávněních spojených s elektronickou knihou.
  • Přispěvatel: Jiní přispěvatelé nebo role přispěvatelů (např. editor, ilustrátor).
  • Typ: Typ obsahu (např. román, učebnice).
  • Formát: Formát souboru elektronické knihy (např. EPUB).
  • Identifikátor: Jedinečný identifikátor elektronické knihy (např. ISBN, DOI).
  • Pokrytí: Geografické nebo časové pokrytí obsahu elektronické knihy.
  • Zdroj: Zdroj obsahu elektronické knihy (pokud existuje).

Změna metadat EPUB v Javě pomocí REST API

Zde jsou kroky a ukázkový kód, který ukazuje, jak změnit metadata EPUB v Javě pomocí REST API.

  1. Vytvořte konfigurační objekt s MyAppSid a MyAppKey.
  2. Inicializujte instanci MetadataApi pomocí vytvořené konfigurace.
  3. Vytvořte objekt SetOptions pro konfiguraci nastavení metadat.
  4. Inicializujte ArrayList objektů SetProperty, aby obsahoval vlastnosti metadat.
  5. Vytvořte objekt SetProperty, který bude reprezentovat jednu vlastnost metadat.
  6. Vytvořte objekt SearchCriteria pro definování kritérií vyhledávání pro metadata.
  7. Vytvořte objekt TagOptions pro určení přesných možností tagu s tagem a kategorií.
  8. Vytvořte objekt Tag a nastavte jeho název na „Creator“ a kategorii na „Person“.
  9. Nastavte přesnou značku v TagOptions pomocí vytvořené Tag.
  10. Nastavte kritéria vyhledávání pomocí vytvořených TagOptions.
  11. Nastavte novou hodnotu metadat, typ a přidejte vlastnost do seznamu vlastností. 7
  12. Nakonfigurujte informace o souboru, včetně cesty k souboru EPUB.
  13. Vytvořte SetRequest pomocí možností.
  14. Nakonec zavolejte metodu set na instanci MetadataApi a uložte odpověď SetResult.

Následující příklad kódu ukazuje, jak změnit metadata EPUB v Javě pomocí REST API.

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
MetadataApi apiInstance = new MetadataApi(configuration);
SetOptions options = new SetOptions();
ArrayList<SetProperty> properties = new ArrayList<SetProperty>();
SetProperty property = new SetProperty();
SearchCriteria searchCriteria = new SearchCriteria();
// Set exact tag options with tag and category
TagOptions tagOptions = new TagOptions();
Tag tag = new Tag();
tag.setName("Creator");
tag.setCategory("Person");
tagOptions.setExactTag(tag);
// Set search criteria
searchCriteria.setTagOptions(tagOptions);
property.setSearchCriteria(searchCriteria);
// Change metadata value
property.setNewValue("GroupDocs-Cloud");
property.setType("string");
properties.add(property);
options.setProperties(properties);
// Apply metadata to EPUB
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("metadata/sample.epub");
options.setFileInfo(fileInfo);
SetRequest request = new SetRequest(options);
SetResult response = apiInstance.set(request);
view raw edit-epub-metadata.java hosted with ❤ by GitHub

Stáhnout výsledný soubor Epub

Kód uvedený v předchozím kroku uloží výsledný soubor do cloudu. Chcete-li jej stáhnout, můžete použít následující fragment kódu.

// api initialization
FileApi apiInstance = new FileApi(clientId, clientSecret);
// create download file request
DownloadFileRequest request = new DownloadFileRequest("metadata/sample_epub/sample.epub", "", null);
File response = apiInstance.downloadFile(request);
view raw download-file.java hosted with ❤ by GitHub

Bonus: Upravujte metadata EPUB online

Online editor metadat EPUB
Vylepšete své zkušenosti se správou metadat pomocí našeho Online editoru metadat EPUB. Tento uživatelsky přívětivý webový nástroj umožňuje vizuálně upravovat vlastnosti metadat bez psaní jediného řádku kódu.

Funkce:

  • Intuitivní uživatelské rozhraní
  • Náhled změn metadat v reálném čase
  • Podpora pro více vlastností metadat EPUB
  • Kompatibilita napříč platformami

Jak používat:

  1. Otevřete v prohlížeči nástroj GroupDocs.Metadata.
  2. Nahrajte nebo přetáhněte soubor EPUB.
  3. Zkontrolujte a upravte metadata.
  4. Uložte a stáhněte aktualizovaný soubor EPUB.

Závěr

V tomto blogovém příspěvku jsme prošli procesem nastavení SDK, inicializace klienta API a změny vlastností metadat pomocí zadaných značek. Jako třešničku jsme jako bonus představili Online editor metadat EPUB, který nabízí uživatelsky přívětivé rozhraní pro bezproblémovou manipulaci s metadaty. Využijte sílu správy metadat a pozvedněte svou sbírku e-knih do nových výšin.

Sada GroupDocs.Metadata Cloud SDK na bázi Java zjednodušuje postup a poskytuje řadu možností přizpůsobení. Neváhejte a prozkoumejte dokumentaci, experimentujte s různými nastaveními a upravujte metadata svých obrázků nebo dokumentů tak, aby hladce odpovídala vašim požadavkům na branding.

Kromě toho objevíte vyhrazenou sekci API reference, která usnadňuje přímou vizualizaci a interakci s našimi API přímo prostřednictvím vašeho webového prohlížeče. Rozsáhlý zdrojový kód Java SDK je otevřeně dostupný na Github.

Nakonec se náš závazek i nadále soustředí na vytváření nového obsahu blogu, který se točí kolem jedinečných formátů souborů a jejich analýzy přes REST API. Zůstaňte ve spojení, abyste získali nejnovější aktualizace. Přejeme vám úspěch a naplnění ve vašem kódovacím úsilí!

Položit otázku

V případě, že byste měli nějaké dotazy nebo nejasnosti ohledně editoru metadat EPUB, neváhejte nás kontaktovat prostřednictvím našeho fóra.

Viz také

Zde je několik souvisejících článků, které vám mohou pomoci: