GroupDocs.Metadata Cloud SDK for Java позволяет разработчикам Java программно читать и изменять свойства документов PDF. В этом руководстве вы узнаете, как редактировать метаданные PDF в Java, обновлять стандартные поля, такие как Title и Author, и добавлять пользовательские пары ключ‑значение. SDK предоставляет простой API для загрузки PDF, изменения его метаданных и сохранения файла обратно в хранилище. Следуйте пошаговым инструкциям, чтобы интегрировать редактирование метаданных в ваши Java‑приложения.

Предварительные требования и настройка

Для работы с PDF‑метаданными вам требуется Java 8 или выше и Maven, установленный на вашей машине разработки. Скачайте последнюю версию со страницы.

Добавьте SDK в ваш Maven‑проект:

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

Или установите его через командную строку:

mvn install com.groupdocs:groupdocs-metadata-cloud

Создайте файл конфигурации (или задайте переменные окружения) с вашим client ID и client secret, полученными из панели управления GroupDocs Cloud. Для этого примера код лицензии не требуется; временную лицензию можно запросить на странице лицензий.

Понимание метаданных PDF

PDF‑файлы содержат набор стандартных свойств (Title, Author, Subject, Keywords) и позволяют использовать пользовательские пары «ключ‑значение». Эти свойства хранятся в словаре метаданных документа и могут быть прочитаны или изменены без изменения визуального содержимого файла.

Ключевые возможности GroupDocs.Metadata Cloud SDK for Java

  • Читайте существующие метаданные из PDF, DOCX, XLSX, и многих других форматов.
  • Обновляйте стандартные свойства, такие как Title, Author, Creator и Producer.
  • Добавляйте, редактируйте или удаляйте пользовательские свойства с помощью простого интерфейса карты.
  • Сохраняйте изменения в оригинальном файле или в новом месте вывода.

Изменение стандартных свойств PDF‑документа

SDK предоставляет класс MetadataInfo, который предоставляет геттеры и сеттеры для всех стандартных полей. Вы также можете получить доступ к коллекции CustomProperties для работы с пользовательскими записями.

Добавление пользовательских полей метаданных

Пользовательские метаданные хранятся в виде словаря строковых ключей и значений. SDK автоматически сериализует эти записи при сохранении документа, делая их доступными для любого PDF‑ридера, поддерживающего пользовательские метаданные.

Шаги по редактированию метаданных PDF в Java

  1. Инициализировать клиент API: Создайте объект Configuration с вашими учётными данными и создайте экземпляр MetadataApi.
  2. Загрузить исходный PDF: Используйте StorageApi для размещения файла в вашем хранилище GroupDocs Cloud.
  3. Загрузить метаданные PDF: Вызовите metadataApi.getMetadataInfo, чтобы получить объект MetadataInfo.
  4. Обновить поля: Установите стандартные свойства (например, setTitle, setAuthor) и добавьте пользовательские записи через getCustomProperties().put("MyKey", "MyValue").
  5. Сохранить изменения: Вызовите metadataApi.updateMetadataInfo, чтобы записать изменённые метаданные обратно в файл.

Для получения более подробной информации о используемых классах, обратитесь к API reference.

Редактирование метаданных PDF в Java — полный пример кода

Следующий пример демонстрирует полный рабочий процесс: аутентификацию, загрузку файла, изменение метаданных и сохранение обновленного PDF.

Примечание: Этот пример кода демонстрирует базовую функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили пути к файлам (sample.pdf, C:/files/sample.pdf) в соответствии с вашими реальными расположениями, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут проблемы, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Редактирование метаданных PDF через REST API с использованием cURL

Если вы предпочитаете не использовать Java‑библиотеку, то ту же операцию можно выполнить через GroupDocs Metadata Cloud REST API.

  1. Получить токен доступа
curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
  1. Загрузите PDF‑файл
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@C:/files/sample.pdf"
  1. Обновить метаданные
curl -X POST "https://api.groupdocs.cloud/v2.0/metadata/pdf/sample.pdf/metadata" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "title":"New Document Title",
           "author":"John Doe",
           "subject":"Updated Subject",
           "customProperties":{"Project":"Alpha","ReviewedBy":"Jane Smith"}
         }'
  1. Скачать обновлённый PDF
   curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o "C:/files/updated_sample.pdf"

Эти команды позволяют интегрировать редактирование метаданных PDF в скрипты, конвейеры CI/CD или любую среду, где установка Java‑библиотеки непрактична. Для полного списка конечных точек см. Документация API.

Заключение

Теперь у вас есть полное понимание того, как редактировать метаданные PDF в Java с помощью GroupDocs.Metadata Cloud SDK for Java. Руководство охватывало чтение существующих метаданных, изменение стандартных полей, таких как Title и Author, добавление пользовательских пар «ключ‑значение» и сохранение изменений. SDK работает на вашем локальном компьютере или сервере и требует действующей лицензии; вы можете начать с временной лицензии со страницы лицензий и перейти на полную коммерческую лицензию для использования в продакшене. Применяйте эти техники, чтобы ваши PDF‑документы были хорошо организованы и легко находились.

Часто задаваемые вопросы

Как отредактировать метаданные PDF в Java с помощью GroupDocs.Metadata Cloud SDK?
Используйте SDK для загрузки PDF, изменения свойств MetadataInfo и сохранения файла. См. документацию GroupDocs.Metadata Cloud SDK for Java для получения подробностей.

Могу ли я добавить пользовательские пары ключ-значение в метаданные PDF?
Да, SDK позволяет добавлять пользовательские записи с помощью метода setCustomProperties. Обратитесь к API reference для примеров.

Достаточна ли временная лицензия для разработки?
Временная лицензия со страницы лицензий позволяет протестировать SDK. Для продакшн‑окружения приобретите полную лицензию.

Где я могу найти больше примеров для работы с метаданными PDF?
Официальная документация и форумы содержат дополнительные образцы и поддержку сообщества.

Read More