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. Для цього прикладу код ліцензії не потрібен; тимчасову ліцензію можна запросити на license page.

Розуміння метаданих 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.

Редагування метаданих 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 для прикладів.

Чи достатня тимчасова ліцензія для розробки?
Тимчасова ліцензія зі сторінки ліцензування дозволяє протестувати SDK. Для продакшн‑середовища придбайте повну ліцензію.

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

Read More