W szybko rozwijającym się środowisku cyfrowym książki elektroniczne (EPUB) zyskały ogromną popularność ze względu na wygodę i dostępność. Jednak zarządzanie metadanymi tych e-booków jest często kluczowym, ale pomijanym aspektem. Metadane zawierają istotne informacje o e-booku, takie jak jego tytuł, autor, data publikacji i inne. W tym poście na blogu przyjrzymy się, jak wykorzystać możliwości Java i GroupDocs.Metadata Cloud API, aby łatwo modyfikować metadane e-booków EPUB za pomocą interfejsu API REST. Dodatkowo przekażemy instrukcje krok po kroku dotyczące konfiguracji pakietu GroupDocs.Metadata Cloud SDK dla języka Java oraz zmiany właściwości metadanych przy użyciu określonych tagów. Jako bonus wprowadzimy także edytor metadanych online EPUB, który usprawni zarządzanie metadanymi.
W tym artykule zostaną omówione następujące punkty:
- Konfigurowanie środowiska
- Inicjowanie klienta API
- Zmień metadane EPUB w Javie przy użyciu interfejsu API REST
- Bonus: internetowy edytor metadanych EPUB
Konfigurowanie środowiska
Warunki wstępne:
Zanim zajmiemy się wdrożeniem, upewnij się, że spełnione są następujące wymagania wstępne:
- Zainstalowano zestaw Java Development Kit (JDK).
- Konto GroupDocs w celu uzyskania poświadczeń API.
- Podstawowa znajomość interfejsów API REST i programowania w języku Java.
Uzyskiwanie danych uwierzytelniających API:
Aby rozpocząć, załóż konto w chmurze GroupDocs i utwórz aplikację. Panel kontrolny zapewni Ci niezbędne dane uwierzytelniające (SID aplikacji i Klucz aplikacji) w celu uwierzytelnienia Twoich żądań.
Dodawanie zestawu SDK Cloud GroupDocs.Metadata dla języka Java:
Aby włączyć pakiet SDK do projektu Java, możesz pobrać plik JAR interfejsu API lub zainstalować go za pomocą narzędzia Maven, dodając następujące repozytorium i zależność do pliku pom.xml projektu:
Repozytorium Mavena:
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
Zależność Mavena:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-metadata-cloud</artifactId>
<version>23.3</version>
<scope>compile</scope>
</dependency>
Inicjowanie klienta API
Aby skonfigurować klienta API, użyj swojego Identyfikatora klienta i Tajemnicy klienta w kodzie pokazanym poniżej:
Zmiana właściwości metadanych EPUB
Ładowanie e-booka EPUB:
Przede wszystkim prześlij e-book EPUB, który chcesz zmodyfikować. Można to osiągnąć, korzystając z dowolnej z poniższych metod przesyłania plików do magazynu w chmurze:
- Prześlij wszystkie pliki jeden po drugim, korzystając z Upload File API w przeglądarce.
- Korzystanie z pulpitu nawigacyjnego.
- Prześlij programowo, korzystając z przykładowego kodu podanego poniżej:
W efekcie przesłane pliki będą dostępne w sekcji plików Twojego dashboardu w chmurze.
Typowe właściwości metadanych EPUB:
Oto kilka typowych właściwości metadanych występujących w plikach EPUB:
- Tytuł: Tytuł e-booka.
- Twórca: Autor lub twórca eBooka.
- Język: Język treści e-booka.
- Wydawca: Wydawca eBooka.
- Opis: Krótki opis lub podsumowanie eBooka.
- Data: Data publikacji lub data utworzenia e-Booka.
- Temat: Słowa kluczowe lub frazy opisujące zawartość eBooka.
- Prawa: Informacje o prawach i uprawnieniach związanych z e-Bookiem.
- Współpracownik: Inni współpracownicy lub role współpracowników (np. redaktor, ilustrator).
- Typ: rodzaj treści (np. powieść, podręcznik).
- Format: Format pliku eBook (np. EPUB).
- Identyfikator: Unikalny identyfikator eBooka (np. ISBN, DOI).
- Zasięg: zasięg geograficzny lub czasowy treści e-booka.
- Źródło: Źródło treści eBooka (jeśli dotyczy).
Zmień metadane EPUB w Javie przy użyciu interfejsu API REST
Oto kroki i przykładowy kod pokazujący, jak zmienić metadane EPUB w Javie za pomocą interfejsu API REST.
- Utwórz obiekt konfiguracyjny z identyfikatorami MyAppSid i MyAppKey.
- Zainicjuj instancję MetadataApi, korzystając z utworzonej konfiguracji.
- Utwórz obiekt SetOptions do konfiguracji ustawień metadanych.
- Zainicjuj ArrayList obiektów SetProperty w celu przechowywania właściwości metadanych.
- Utwórz obiekt SetProperty reprezentujący pojedynczą właściwość metadanych.
- Utwórz obiekt SearchCriteria, aby zdefiniować kryteria wyszukiwania metadanych.
- Utwórz obiekt TagOptions, aby określić dokładne opcje tagu za pomocą tagu i kategorii.
- Utwórz obiekt Tag i ustaw jego nazwę na „Twórca” i kategorię na „Osoba”.
- Ustaw dokładny tag w TagOptions, używając utworzonego Tag.
- Ustaw kryteria wyszukiwania korzystając z utworzonych TagOptions.
- Ustaw nową wartość metadanych, wpisz i dodaj właściwość do listy właściwości. 7
- Skonfiguruj informacje o pliku, w tym ścieżkę pliku EPUB.
- Utwórz SetRequest, korzystając z opcji.
- Na koniec wywołaj metodę set w instancji MetadataApi i zapisz odpowiedź SetResult.
Poniższy przykład kodu pokazuje, jak zmienić metadane EPUB w Javie przy użyciu interfejsu API REST.
Pobierz wynikowy plik Epub
Kod podany w poprzednim kroku zapisuje powstały plik w chmurze. Aby go pobrać, możesz użyć poniższego fragmentu kodu.
Bonus: Edytuj metadane EPUB online
Cechy:
- Intuicyjny interfejs użytkownika
- Podgląd zmian metadanych w czasie rzeczywistym
- Obsługa wielu właściwości metadanych EPUB
- Kompatybilność między platformami
Jak używać:
- Otwórz narzędzie GroupDocs.Metadata w przeglądarce.
- Prześlij lub przeciągnij plik EPUB.
- Przejrzyj i edytuj metadane.
- Zapisz i pobierz zaktualizowaną wersję EPUB.
Wniosek
W tym poście na blogu omówiliśmy proces konfigurowania pakietu SDK, inicjowania klienta API i zmiany właściwości metadanych za pomocą określonych tagów. Jako dodatek wprowadziliśmy jako bonus internetowy edytor metadanych EPUB, oferujący przyjazny dla użytkownika interfejs umożliwiający bezproblemową manipulację metadanymi. Wykorzystaj moc zarządzania metadanymi i wznieś swoją kolekcję e-booków na nowy poziom.
Oparty na Javie pakiet SDK GroupDocs.Metadata Cloud SDK upraszcza procedurę i zapewnia różnorodne opcje dostosowywania. Zachęcamy do zapoznania się z dokumentacją, eksperymentowania z różnymi ustawieniami i modyfikowania metadanych obrazów lub dokumentów, aby bezproblemowo dostosować je do wymagań dotyczących marki.
Ponadto znajdziesz dedykowaną sekcję Informacje o interfejsie API, która ułatwia bezpośrednią wizualizację i interakcję z naszymi interfejsami API bezpośrednio za pośrednictwem przeglądarki internetowej. Rozbudowany kod źródłowy pakietu Java SDK jest ogólnodostępny na Github.
Ostatecznie nasze zaangażowanie pozostaje skupione na tworzeniu świeżej zawartości bloga, która dotyczy unikalnych formatów plików i ich analizy za pośrednictwem interfejsu API REST. Pozostań w kontakcie, aby uzyskać najnowsze aktualizacje. Życzymy sukcesów i spełnienia w kodowaniu!
Zadać pytanie
W przypadku pytań lub niejasności związanych z edytorem metadanych EPUB prosimy o kontakt za pośrednictwem naszego forum.
Zobacz też
Oto kilka powiązanych artykułów, które mogą okazać się pomocne: