В быстро развивающейся цифровой среде электронные книги (EPUB) приобрели огромную популярность благодаря своему удобству и доступности. Однако управление метаданными этих электронных книг часто является важным, но упускаемым из виду аспектом. Метаданные содержат важную информацию об электронной книге, такую как ее название, автор, дата публикации и т. д. В этом сообщении блога мы рассмотрим, как использовать возможности Java и GroupDocs.Metadata Cloud API, чтобы легко изменять метаданные электронной книги EPUB с помощью REST API. Кроме того, мы предоставим пошаговые инструкции по настройке GroupDocs.Metadata Cloud SDK для Java и изменению свойств метаданных с помощью указанных тегов. В качестве бонуса мы также представим онлайн-редактор метаданных EPUB, который расширит ваши возможности управления метаданными.
В этой статье будут рассмотрены следующие моменты:
- Настройка среды
- Инициализация API-клиента
- Изменить метаданные EPUB в Java с помощью REST API
- Бонус: онлайн-редактор метаданных EPUB
Настройка среды
Предпосылки:
Прежде чем мы углубимся в реализацию, убедитесь, что у вас есть следующие предварительные условия:
- Установлен пакет разработки Java (JDK).
- Учетная запись GroupDocs для получения учетных данных API.
- Базовое понимание REST API и программирования на Java.
Получение учетных данных API:
Чтобы начать, зарегистрируйте облачную учетную запись GroupDocs и создайте приложение. Панель мониторинга предоставит вам необходимые учетные данные (SID приложения и Ключ приложения) для аутентификации ваших запросов.
Добавление Cloud SDK GroupDocs.Metadata для 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, которую хотите изменить. Вы можете сделать это, используя любой из следующих методов загрузки файлов в облачное хранилище:
- Загрузите все файлы один за другим с помощью API загрузки файлов из браузера.
- Использование панели управления.
- Загрузите программно, используя пример кода, приведенный ниже:
В результате загруженные файлы будут доступны в разделе файлов вашего личного кабинета в облаке.
Общие свойства метаданных EPUB:
Вот некоторые распространенные свойства метаданных, обнаруженные в файлах EPUB:
- Название: название электронной книги.
- Создатель: автор или создатель электронной книги.
- Язык: язык содержимого электронной книги.
- Издатель: издатель электронной книги.
- Описание: краткое описание или краткое содержание электронной книги.
- Дата: дата публикации или дата создания электронной книги.
- Тема: ключевые слова или фразы, описывающие содержание электронной книги.
- Права: информация о правах и разрешениях, связанных с электронной книгой.
- Соавтор: другие участники или роли участников (например, редактор, иллюстратор).
- Тип: тип контента (например, роман, учебник).
- Формат: формат файла электронной книги (например, EPUB).
- Идентификатор: уникальный идентификатор электронной книги (например, ISBN, DOI).
- Охват: географический или временной охват содержимого электронной книги.
- Источник: источник содержимого электронной книги (если применимо).
Изменение метаданных EPUB в Java с помощью REST API
Ниже приведены шаги и пример кода, показывающие, как изменить метаданные EPUB в Java с помощью REST API.
- Создайте объект конфигурации с MyAppSid и MyAppKey.
- Инициализируйте экземпляр MetadataApi, используя созданную конфигурацию.
- Создайте объект SetOptions для настройки параметров метаданных.
- Инициализируйте ArrayList объектов SetProperty для хранения свойств метаданных.
- Создайте объект SetProperty для представления одного свойства метаданных.
- Создайте объект SearchCriteria, чтобы определить критерии поиска метаданных.
- Создайте объект TagOptions, чтобы указать точные параметры тега с помощью тега и категории.
- Создайте объект «Тег» и установите для него имя «Создатель» и категорию «Человек».
- Установите точный тег в TagOptions, используя созданный Tag.
- Задайте критерии поиска, используя созданные TagOptions.
- Задайте новое значение метаданных, введите и добавьте свойство в список свойств. 7
- Настройте информацию о файле, включая путь к файлу EPUB.
- Создайте SetRequest, используя параметры.
- Наконец, вызовите метод set для экземпляра MetadataApi и сохраните ответ SetResult.
В следующем примере кода показано, как изменить метаданные EPUB в Java с помощью REST API.
Загрузить результирующий файл Epub
Код, приведенный на предыдущем шаге, сохраняет полученный файл в облаке. Чтобы загрузить его, вы можете использовать следующий фрагмент кода.
Бонус: редактируйте метаданные EPUB онлайн.
Функции:
- Интуитивно понятный пользовательский интерфейс
- Предварительный просмотр изменений метаданных в реальном времени.
- Поддержка нескольких свойств метаданных EPUB.
- Кроссплатформенная совместимость
Как использовать:
- Откройте инструмент GroupDocs.Метаданные в браузере.
- Загрузите или перетащите файл EPUB.
- Просмотрите и отредактируйте метаданные.
- Сохраните и загрузите обновленный файл EPUB.
Заключение
В этом сообщении блога мы рассмотрели процесс настройки SDK, инициализации клиента API и изменения свойств метаданных с помощью указанных тегов. В качестве вишенки на торте мы в качестве бонуса представили онлайн-редактор метаданных EPUB, предлагающий удобный интерфейс для удобного манипулирования метаданными. Воспользуйтесь возможностями управления метаданными и поднимите свою коллекцию электронных книг на новую высоту.
Облачный SDK GroupDocs.Metadata на основе Java упрощает процедуру и предоставляет множество возможностей для настройки. Не стесняйтесь изучать документацию, экспериментировать с различными настройками и изменять метаданные для ваших изображений или документов, чтобы они полностью соответствовали вашим требованиям к брендингу.
Кроме того, вы обнаружите специальный раздел ссылка на API, который облегчает прямую визуализацию и взаимодействие с нашими API непосредственно через ваш веб-браузер. Обширный исходный код Java SDK находится в открытом доступе на Github.
В конечном итоге, наша цель по-прежнему сосредоточена на создании свежего контента для блогов, основанного на уникальных форматах файлов и их анализе с помощью REST API. Оставайтесь на связи для получения самых последних обновлений. Желаем вам успехов и достижений в ваших начинаниях по программированию!
Задайте вопрос
Если у вас возникнут какие-либо вопросы или сомнения по поводу редактора метаданных EPUB, свяжитесь с нами через наш форум.
Смотрите также
Вот несколько статей по теме, которые могут оказаться вам полезными: