GroupDocs.Metadata Cloud SDK for Java permet aux développeurs Java de lire et de modifier de manière programmatique les propriétés des documents PDF. Dans ce guide, vous apprendrez comment modifier les métadonnées PDF en Java, mettre à jour les champs standard tels que Titre et Auteur, et ajouter des paires clé‑valeur personnalisées. Le SDK fournit une API simple pour charger un PDF, modifier ses métadonnées et enregistrer le fichier dans le stockage. Suivez les instructions étape par étape pour intégrer la modification des métadonnées dans vos applications Java.

Prérequis et configuration

Pour travailler avec les métadonnées PDF, vous avez besoin de Java 8 ou supérieur et de Maven installé sur votre machine de développement. Téléchargez la dernière version depuis cette page.

Ajoutez le SDK à votre projet Maven :

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

Ou installez‑le via la ligne de commande:

mvn install com.groupdocs:groupdocs-metadata-cloud

Créez un fichier de configuration (ou définissez des variables d’environnement) avec votre ID client et votre secret client obtenus depuis le tableau de bord GroupDocs Cloud. Aucun code de licence n’est requis pour cet exemple ; une licence temporaire peut être demandée depuis la page de licence.

Comprendre les métadonnées PDF

Les fichiers PDF contiennent un ensemble de propriétés standard (Title, Author, Subject, Keywords) et permettent des paires clé‑valeur personnalisées. Ces propriétés sont stockées dans le dictionnaire de métadonnées du document et peuvent être lues ou modifiées sans altérer le contenu visuel du fichier.

Principales fonctionnalités de GroupDocs.Metadata Cloud SDK for Java

  • Lire les métadonnées existantes à partir de PDF, DOCX, XLSX, et de nombreux autres formats.
  • Mettre à jour les propriétés standard telles que Titre, Auteur, Créateur et Producteur.
  • Ajouter, modifier ou supprimer des propriétés personnalisées à l’aide d’une interface de type carte simple.
  • Enregistrer les modifications dans le fichier original ou vers un nouvel emplacement de sortie.

Modification des propriétés standard du document PDF

Le SDK expose la classe MetadataInfo qui fournit des getters et des setters pour tous les champs standard. Vous pouvez également accéder à la collection CustomProperties pour travailler avec des entrées définies par l’utilisateur.

Ajout de champs de métadonnées personnalisés

Les métadonnées personnalisées sont stockées sous forme d’un dictionnaire de clés et de valeurs de type chaîne. Le SDK sérialise automatiquement ces entrées lors de l’enregistrement du document, les rendant disponibles pour tout lecteur PDF prenant en charge les métadonnées personnalisées.

Étapes pour modifier les métadonnées PDF en Java

  1. Initialiser le client API: Créez un objet Configuration avec vos identifiants et instanciez le MetadataApi.
  2. Télécharger le PDF source: Utilisez le StorageApi pour placer le fichier dans votre stockage GroupDocs Cloud.
  3. Charger les métadonnées du PDF: Appelez metadataApi.getMetadataInfo pour récupérer un objet MetadataInfo.
  4. Mettre à jour les champs: Définissez les propriétés standard (par ex., setTitle, setAuthor) et ajoutez des entrées personnalisées via getCustomProperties().put("MyKey", "MyValue").
  5. Enregistrer les modifications: Invoquez metadataApi.updateMetadataInfo pour écrire les métadonnées modifiées dans le fichier.

Pour plus de détails sur les classes utilisées, consultez la référence API.

Modifier les métadonnées PDF en Java - Exemple de code complet

L’exemple suivant montre un flux de travail complet : authentification, téléchargement de fichier, modification des métadonnées et enregistrement du PDF mis à jour.

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour les chemins de fichiers (sample.pdf, C:/files/sample.pdf) afin qu’ils correspondent à vos emplacements réels, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Modifier les métadonnées PDF via l’API REST en utilisant cURL

Si vous préférez ne pas utiliser la bibliothèque Java, la même opération peut être effectuée via le GroupDocs Metadata Cloud REST API.

  1. Obtenir un jeton d’accès
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. Téléverser le fichier 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. Mettre à jour les métadonnées
   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. Télécharger le PDF mis à jour
   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"

Ces commandes vous permettent d’intégrer la modification des métadonnées PDF dans des scripts, des pipelines CI/CD ou tout environnement où l’installation de la bibliothèque Java n’est pas pratique. Pour une liste complète des points de terminaison, consultez la documentation de l’API.

Conclusion

Vous avez maintenant une compréhension complète de la façon de modifier les métadonnées PDF en Java à l’aide de GroupDocs.Metadata Cloud SDK for Java. Le guide a couvert la lecture des métadonnées existantes, la modification des champs standard tels que Titre et Auteur, l’ajout de paires clé‑valeur personnalisées et la persistance des modifications. Le SDK s’exécute sur votre machine locale ou serveur et nécessite une licence valide ; vous pouvez commencer avec une licence temporaire depuis la page de licence et passer à une licence commerciale complète pour une utilisation en production. Intégrez ces techniques pour garder vos documents PDF bien organisés et recherchables.

FAQ

Comment puis‑je modifier les métadonnées PDF en Java à l’aide du GroupDocs.Metadata Cloud SDK ?
Utilisez le SDK pour charger un PDF, modifier ses propriétés MetadataInfo et enregistrer le fichier. Consultez la documentation du GroupDocs.Metadata Cloud SDK for Java pour plus de détails.

Puis-je ajouter des paires clé-valeur personnalisées aux métadonnées d’un PDF ?
Oui, le SDK permet d’ajouter des entrées personnalisées via la méthode setCustomProperties. Consultez la référence API pour des exemples.

Une licence temporaire suffit-elle pour le développement ?
Une licence temporaire provenant de la page de licence vous permet de tester le SDK. Pour la production, achetez une licence complète.

Où puis-je trouver plus d’exemples pour la manipulation des métadonnées PDF ?
La documentation officielle et les forums contiennent des exemples supplémentaires ainsi qu’un support communautaire.

En savoir plus