У цифровому середовищі, що швидко розвивається, електронні книги (EPUBs) набули величезної популярності завдяки своїй зручності та доступності. Однак керування метаданими цих електронних книг часто є важливим, але забутим аспектом. Метадані містять важливу інформацію про електронну книгу, таку як її назва, автор, дата публікації тощо. У цій публікації блогу ми розглянемо, як використовувати потужність Java і GroupDocs.Metadata Cloud API, щоб легко змінювати метадані електронної книги EPUB за допомогою REST API. Крім того, ми надамо покрокові інструкції щодо налаштування GroupDocs.Metadata Cloud SDK для Java та зміни властивостей метаданих за допомогою вказаних тегів. Як бонус ми також представимо онлайн-редактор метаданих EPUB, щоб покращити ваш досвід керування метаданими.
У цій статті будуть розглянуті такі моменти:
- Налаштування середовища
- Ініціалізація клієнта API
- Змінити метадані EPUB у Java за допомогою REST API
- Бонус: онлайн-редактор метаданих EPUB
Налаштування середовища
Передумови:
Перш ніж ми заглибимося в реалізацію, переконайтеся, що у вас є такі передумови:
— Встановлено Java Development Kit (JDK).
- Обліковий запис GroupDocs для отримання облікових даних API.
- Базове розуміння REST API та програмування на Java.
Отримання облікових даних API:
Щоб розпочати роботу, зареєструйтесь у хмарному обліковому записі GroupDocs і створіть програму. Інформаційна панель надасть вам необхідні облікові дані (App SID і App Key) для автентифікації ваших запитів.
Додавання GroupDocs.Metadata Cloud SDK для Java:
Щоб інтегрувати SDK у свій проект Java, ви можете завантажити JAR-файл API або встановити його за допомогою Maven, додавши таке сховище та залежність у файл pom.xml вашого проекту:
Репозиторій Maven:
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
Залежність Maven:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-metadata-cloud</artifactId>
<version>23.3</version>
<scope>compile</scope>
</dependency>
Ініціалізація клієнта API
Щоб налаштувати клієнт API, використовуйте свій Ідентифікатор клієнта та Секрет клієнта у наведеному нижче коді:
Зміна властивостей метаданих EPUB
Завантаження електронної книги EPUB:
Перш за все, завантажте електронну книгу EPUB, яку хочете змінити. Ви можете досягти цього, застосувавши будь-який із наступних методів для завантаження файлів у хмарне сховище:
- Завантажте всі файли один за одним за допомогою Upload File API з браузера.
- Використання інформаційної панелі.
- Завантажте програмним способом, використовуючи наведений нижче приклад коду:
У результаті завантажені файли будуть доступні в розділі файлів вашої інформаційної панелі в хмарі.
Загальні властивості метаданих EPUB:
Ось деякі типові властивості метаданих у файлах EPUB:
- Назва: назва електронної книги.
- Творець: автор або творець електронної книги.
- Мова: мова вмісту електронної книги.
- Видавець: Видавець електронної книги.
- Опис: короткий опис або короткий зміст електронної книги.
- Дата: дата публікації або створення електронної книги.
- Тема: ключові слова або фрази, що описують вміст електронної книги.
- Права: інформація про права та дозволи, пов’язані з електронною книгою.
- Учасник: інші учасники або ролі учасників (наприклад, редактор, ілюстратор).
- Тип: тип вмісту (наприклад, роман, підручник).
- Формат: формат файлу електронної книги (наприклад, EPUB).
- Ідентифікатор: унікальний ідентифікатор електронної книги (наприклад, ISBN, DOI).
- Покриття: географічне або часове охоплення вмісту електронної книги.
- Джерело: джерело вмісту електронної книги (якщо застосовно).
Змінити метадані EPUB у Java за допомогою REST API
Ось кроки та зразок коду, який показує, як змінити метадані EPUB у Java за допомогою REST API.
- Створіть об’єкт конфігурації з MyAppSid і MyAppKey.
- Ініціалізуйте примірник MetadataApi за допомогою створеної конфігурації.
- Створіть об’єкт SetOptions для налаштування параметрів метаданих.
- Ініціалізуйте ArrayList об’єктів SetProperty для зберігання властивостей метаданих.
- Створіть об’єкт SetProperty для представлення окремої властивості метаданих.
- Створіть об’єкт SearchCriteria, щоб визначити критерії пошуку для метаданих.
- Створіть об’єкт TagOptions, щоб указати точні параметри тегів за допомогою тегу та категорії.
- Створіть об’єкт Tag і встановіть для нього ім’я «Творець» і категорію «Особа».
- Встановіть точний тег у TagOptions за допомогою створеного Tag.
- Встановіть критерії пошуку за допомогою створених TagOptions.
- Встановіть нове значення метаданих, тип і додайте властивість до списку властивостей. 7
- Налаштуйте інформацію про файл, включаючи шлях до файлу EPUB.
- Створіть SetRequest за допомогою параметрів.
- Нарешті, викличте метод set в екземплярі MetadataApi і збережіть відповідь SetResult.
У наведеному нижче прикладі коду показано, як змінити метадані EPUB у Java за допомогою REST API.
Завантажте отриманий файл Epub
Код, наведений у попередньому кроці, зберігає отриманий файл у хмарі. Щоб завантажити його, ви можете використати наведений нижче фрагмент коду.
Бонус: редагуйте метадані EPUB онлайн
Особливості:
- Інтуїтивно зрозумілий інтерфейс користувача
- Попередній перегляд змін метаданих у реальному часі — Підтримка кількох властивостей метаданих EPUB — Кросплатформна сумісність
Як використовувати:
- Відкрийте інструмент GroupDocs.Metadata у браузері.
- Завантажте або перетягніть файл EPUB.
- Перегляньте та відредагуйте метадані.
- Збережіть і завантажте оновлений EPUB.
Висновок
У цій публікації блогу ми ознайомилися з процесом налаштування SDK, ініціалізації клієнта API та зміни властивостей метаданих із зазначеними тегами. Як вишеньку на вершині ми представили онлайн-редактор метаданих EPUB як бонус, який пропонує зручний інтерфейс для безпроблемної роботи з метаданими. Скористайтеся можливостями керування метаданими та підніміть свою колекцію електронних книг на нову висоту.
Пакет SDK GroupDocs.Metadata Cloud на основі Java спрощує процедуру та надає різноманітні параметри для налаштування. Не соромтеся досліджувати документацію, експериментувати з різними налаштуваннями та змінювати метадані для ваших зображень або документів, щоб повністю відповідати вашим вимогам брендингу.
Крім того, ви знайдете спеціальний розділ API reference, який полегшує пряму візуалізацію та взаємодію з нашими API безпосередньо через ваш веб-браузер. Розширений вихідний код Java SDK відкрито доступний на Github.
Зрештою, наше зобов’язання залишається зосередженим на створенні свіжого вмісту блогу, який обертається навколо унікальних форматів файлів та їх синтаксичного аналізу за допомогою REST API. Залишайтеся на зв’язку, щоб отримувати останні оновлення. Бажаємо вам успіху та реалізації у ваших починаннях кодування!
Задайте питання
Якщо у вас виникли запитання чи непорозуміння щодо редактора метаданих EPUB, будь ласка, зв’яжіться з нами через наш форум.
Дивись також
Ось деякі пов’язані статті, які можуть бути вам корисними: