GroupDocs.Metadata Cloud SDK for Java umożliwia programistom Java programowe odczytywanie i modyfikowanie właściwości dokumentów PDF. W tym przewodniku dowiesz się, jak edytować metadane PDF w Javie, aktualizować standardowe pola, takie jak Tytuł i Autor, oraz dodawać własne pary klucz‑wartość. SDK zapewnia prosty interfejs API do załadowania pliku PDF, zmiany jego metadanych i zapisania pliku z powrotem w magazynie. Postępuj zgodnie z instrukcjami krok po kroku, aby zintegrować edycję metadanych w swoich aplikacjach Java.

Wymagania wstępne i konfiguracja

Aby pracować z metadanymi PDF, potrzebujesz Java 8 lub nowszej oraz Maven zainstalowanego na maszynie deweloperskiej. Pobierz najnowszą wersję z tej strony.

Dodaj SDK do swojego projektu Maven:

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

Lub zainstaluj go z wiersza poleceń:

mvn install com.groupdocs:groupdocs-metadata-cloud

Utwórz plik konfiguracyjny (lub ustaw zmienne środowiskowe) z identyfikatorem klienta i sekretem klienta uzyskanymi z panelu GroupDocs Cloud. Kod licencji nie jest wymagany w tym przykładzie; tymczasową licencję można zamówić na stronie licencji.

Zrozumienie metadanych PDF

Pliki PDF zawierają zestaw standardowych właściwości (Title, Author, Subject, Keywords) i umożliwiają niestandardowe pary klucz‑wartość. Właściwości te są przechowywane w słowniku metadanych dokumentu i mogą być odczytywane lub modyfikowane bez zmiany wizualnej treści pliku.

Kluczowe funkcje GroupDocs.Metadata Cloud SDK for Java

  • Odczytaj istniejące metadane z PDF, DOCX, XLSX, oraz wielu innych formatów.
  • Zaktualizuj standardowe właściwości, takie jak Tytuł, Autor, Twórca i Producent.
  • Dodaj, edytuj lub usuń własne właściwości przy użyciu prostego interfejsu mapy.
  • Zapisz zmiany z powrotem do oryginalnego pliku lub do nowej lokalizacji wyjściowej.

Modyfikowanie standardowych właściwości dokumentu PDF

SDK udostępnia klasę MetadataInfo, która zapewnia gettery i settery dla wszystkich standardowych pól. Możesz również uzyskać dostęp do kolekcji CustomProperties, aby pracować z wpisami definiowanymi przez użytkownika.

Dodawanie niestandardowych pól metadanych

Niestandardowe metadane są przechowywane jako słownik kluczy i wartości typu string. SDK automatycznie serializuje te wpisy podczas zapisywania dokumentu, udostępniając je dowolnemu czytnikowi PDF obsługującemu niestandardowe metadane.

Kroki edycji metadanych PDF w Javie

  1. Zainicjalizuj klienta API: Utwórz obiekt Configuration z swoimi danymi uwierzytelniającymi i zainstaluj MetadataApi.
  2. Prześlij źródłowy PDF: Użyj StorageApi, aby umieścić plik w magazynie GroupDocs Cloud.
  3. Wczytaj metadane PDF: Wywołaj metadataApi.getMetadataInfo, aby pobrać obiekt MetadataInfo.
  4. Zaktualizuj pola: Ustaw standardowe właściwości (np. setTitle, setAuthor) i dodaj własne wpisy za pomocą getCustomProperties().put("MyKey", "MyValue").
  5. Zapisz zmiany: Wywołaj metadataApi.updateMetadataInfo, aby zapisać zmodyfikowane metadane z powrotem do pliku.

Aby uzyskać więcej informacji o używanych klasach, zobacz odwołanie do API.

Edytuj metadane PDF w Javie - kompletny przykład kodu

Poniższy przykład demonstruje pełny przepływ pracy: uwierzytelnianie, przesyłanie pliku, modyfikację metadanych i zapisywanie zaktualizowanego pliku PDF.

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (sample.pdf, C:/files/sample.pdf), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są poprawnie zainstalowane, oraz dokładnie przetestuj w środowisku programistycznym. Jeśli napotkasz jakiekolwiek problemy, zapoznaj się z oficjalną dokumentacją lub skontaktuj się z zespołem wsparcia, aby uzyskać pomoc.

Edytuj metadane PDF za pomocą REST API przy użyciu cURL

Jeśli wolisz nie używać biblioteki Java, tę samą operację można wykonać za pośrednictwem GroupDocs Metadata Cloud REST API.

  1. Uzyskaj token dostępu
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. Prześlij plik 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. Aktualizuj metadane
   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. Pobierz zaktualizowany 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"

Te polecenia umożliwiają integrację edycji metadanych PDF w skryptach, pipeline’ach CI/CD lub w dowolnym środowisku, w którym instalacja biblioteki Java nie jest praktyczna. Pełną listę punktów końcowych znajdziesz w dokumentacji API.

Podsumowanie

Teraz masz pełne zrozumienie, jak edytować metadane PDF w Javie przy użyciu GroupDocs.Metadata Cloud SDK for Java. Poradnik obejmował odczytywanie istniejących metadanych, modyfikowanie standardowych pól, takich jak Title i Author, dodawanie własnych par klucz‑wartość oraz zapisywanie zmian. SDK działa na Twoim lokalnym komputerze lub serwerze i wymaga ważnej licencji; możesz rozpocząć od tymczasowej licencji ze strony licencji i przejść na pełną licencję komercyjną do użytku produkcyjnego. Wykorzystaj te techniki, aby Twoje dokumenty PDF były dobrze zorganizowane i łatwe do wyszukiwania.

Najczęściej zadawane pytania

Jak mogę edytować metadane PDF w Javie przy użyciu GroupDocs.Metadata Cloud SDK?
Użyj SDK, aby załadować plik PDF, zmodyfikować jego właściwości MetadataInfo i zapisać plik. Zobacz dokumentację GroupDocs.Metadata Cloud SDK for Java po szczegóły.

Czy mogę dodać własne pary klucz‑wartość do metadanych PDF?
Tak, SDK umożliwia dodawanie własnych wpisów za pomocą metody setCustomProperties. Odwołaj się do referencji API po przykłady.

Czy tymczasowa licencja wystarczy do rozwoju?
Tymczasowa licencja ze strony licencji pozwala przetestować SDK. W środowisku produkcyjnym zakup pełną licencję.

Gdzie mogę znaleźć więcej przykładów manipulacji metadanymi PDF?
Oficjalna dokumentacja oraz fora zawierają dodatkowe przykłady i wsparcie społeczności.

Czytaj więcej