GroupDocs.Metadata Cloud SDK for Java ermöglicht Java‑Entwicklern das programmgesteuerte Lesen und Ändern von PDF-Dokumenteneigenschaften. In diesem Leitfaden erfahren Sie, wie Sie PDF‑Metadaten in Java bearbeiten, Standardfelder wie Titel und Autor aktualisieren und benutzerdefinierte Schlüssel‑Wert‑Paare hinzufügen. Das SDK bietet eine einfache API zum Laden einer PDF, zum Ändern ihrer Metadaten und zum Speichern der Datei zurück im Speicher. Befolgen Sie die Schritt‑für‑Schritt‑Anleitung, um die Metadatenbearbeitung in Ihre Java‑Anwendungen zu integrieren.

Voraussetzungen und Einrichtung

Um mit PDF‑Metadaten zu arbeiten, benötigen Sie Java 8 oder höher und Maven, das auf Ihrer Entwicklungsmaschine installiert ist. Laden Sie die neueste Version von dieser Seite herunter.

Fügen Sie das SDK zu Ihrem Maven‑Projekt hinzu:

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

Oder installieren Sie es über die Befehlszeile:

mvn install com.groupdocs:groupdocs-metadata-cloud

Erstellen Sie eine Konfigurationsdatei (oder setzen Sie Umgebungsvariablen) mit Ihrer Client‑ID und Ihrem Client‑Secret, die Sie vom GroupDocs Cloud‑Dashboard erhalten haben. Für dieses Beispiel ist kein Lizenzcode erforderlich; eine temporäre Lizenz kann von der Lizenzseite angefordert werden.

PDF-Metadaten verstehen

PDF-Dateien enthalten einen Satz von Standard‑Eigenschaften (Title, Author, Subject, Keywords) und erlauben benutzerdefinierte Schlüssel‑Wert‑Paare. Diese Eigenschaften werden im Metadaten‑Dictionary des Dokuments gespeichert und können gelesen oder geändert werden, ohne den visuellen Inhalt der Datei zu verändern.

Hauptfunktionen von GroupDocs.Metadata Cloud SDK for Java

  • Lesen Sie vorhandene Metadaten aus PDF, DOCX, XLSX, und vielen anderen Formaten.
  • Aktualisieren Sie Standard‑Eigenschaften wie Titel, Autor, Ersteller und Produzent.
  • Fügen Sie benutzerdefinierte Eigenschaften hinzu, bearbeiten oder entfernen Sie sie über eine einfache Map‑Schnittstelle.
  • Speichern Sie Änderungen zurück in die Originaldatei oder an einem neuen Ausgabepfad.

Ändern von Standard-PDF-Dokumenteigenschaften

Das SDK stellt die Klasse MetadataInfo bereit, die Getter und Setter für alle Standardfelder bietet. Sie können auch auf die Sammlung CustomProperties zugreifen, um mit benutzerdefinierten Einträgen zu arbeiten.

Hinzufügen benutzerdefinierter Metadatenfelder

Benutzerdefinierte Metadaten werden als Wörterbuch mit Zeichenketten‑Schlüsseln und -Werten gespeichert. Das SDK serialisiert diese Einträge automatisch, wenn das Dokument gespeichert wird, und macht sie für jeden PDF‑Reader verfügbar, der benutzerdefinierte Metadaten unterstützt.

Schritte zum Bearbeiten von PDF-Metadaten in Java

  1. API-Client initialisieren: Erstellen Sie ein Configuration‑Objekt mit Ihren Anmeldeinformationen und instanziieren Sie die MetadataApi.
  2. Quell‑PDF hochladen: Verwenden Sie die StorageApi, um die Datei in Ihrem GroupDocs Cloud‑Speicher abzulegen.
  3. PDF‑Metadaten laden: Rufen Sie metadataApi.getMetadataInfo auf, um ein MetadataInfo‑Objekt zu erhalten.
  4. Felder aktualisieren: Setzen Sie Standard‑Eigenschaften (z. B. setTitle, setAuthor) und fügen Sie benutzerdefinierte Einträge über getCustomProperties().put("MyKey", "MyValue") hinzu.
  5. Änderungen speichern: Rufen Sie metadataApi.updateMetadataInfo auf, um die geänderten Metadaten zurück in die Datei zu schreiben.

Weitere Details zu den verwendeten Klassen finden Sie in der API-Referenz.

PDF-Metadaten in Java bearbeiten – vollständiges Codebeispiel

Das folgende Beispiel demonstriert einen vollständigen Workflow: Authentifizierung, Datei‑Upload, Metadatenänderung und das Speichern der aktualisierten PDF.

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (sample.pdf, C:/files/sample.pdf) an Ihre tatsächlichen Speicherorte anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

PDF-Metadaten über die REST-API mit cURL bearbeiten

Wenn Sie die Java‑Bibliothek nicht verwenden möchten, kann dieselbe Operation über die GroupDocs Metadata Cloud REST API durchgeführt werden.

  1. Zugriffstoken erhalten
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-Datei hochladen
   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. Metadaten aktualisieren
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. Laden Sie das aktualisierte PDF herunter
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"

Mit diesen Befehlen können Sie die PDF‑Metadatenbearbeitung in Skripte, CI/CD‑Pipelines oder jede Umgebung integrieren, in der die Installation der Java‑Bibliothek nicht praktikabel ist. Eine vollständige Liste der Endpunkte finden Sie in der API‑Dokumentation.

Fazit

Sie haben nun ein vollständiges Verständnis dafür, wie Sie PDF‑Metadaten in Java mit GroupDocs.Metadata Cloud SDK for Java bearbeiten. Der Leitfaden behandelte das Lesen vorhandener Metadaten, das Ändern standardmäßiger Felder wie Titel und Autor, das Hinzufügen benutzerdefinierter Schlüssel‑Wert‑Paare und das Persistieren der Änderungen. Das SDK läuft auf Ihrem lokalen Rechner oder Server und erfordert eine gültige Lizenz; Sie können mit einer temporären Lizenz von der Lizenzseite beginnen und für den Produktionseinsatz auf eine vollständige kommerzielle Lizenz upgraden. Integrieren Sie diese Techniken, um Ihre PDF‑Dokumente gut organisiert und durchsuchbar zu halten.

Häufig gestellte Fragen

Wie kann ich PDF‑Metadaten in Java mit dem GroupDocs.Metadata Cloud SDK bearbeiten?
Verwenden Sie das SDK, um ein PDF zu laden, die Eigenschaften von MetadataInfo zu ändern und die Datei zu speichern. Siehe die Dokumentation zum GroupDocs.Metadata Cloud SDK for Java für Details.

Kann ich benutzerdefinierte Schlüssel‑Wert‑Paare zu den Metadaten einer PDF hinzufügen?
Ja, das SDK ermöglicht das Hinzufügen benutzerdefinierter Einträge über die Methode setCustomProperties. Siehe die API‑Referenz für Beispiele.

Ist eine temporäre Lizenz für die Entwicklung ausreichend?
Eine temporäre Lizenz von der Lizenzseite ermöglicht es Ihnen, das SDK zu testen. Für die Produktion erwerben Sie eine Volllizenz.

Wo finde ich weitere Beispiele für die PDF-Metadatenmanipulation?
Die offizielle Dokumentation und die Foren enthalten zusätzliche Beispiele und Community‑Support.

Mehr lesen