Lecture et ajout de métadonnées XMP dans les documents EPS/PS avec Java
Extrayez, inspectez, ajoutez et mettez à jour les métadonnées XMP (Extensible Metadata Platform) dans les documents EPS et PostScript (PS) à l’aide d’Aspose.Page for Java. Intégrez des propriétés Dublin Core standard, des statistiques de création de documents, des informations de droits d’auteur et des structures de métadonnées personnalisées directement dans les flux de fichiers PostScript sans modifier le contenu visuel sous-jacent des graphiques vectoriels.
Aspose.Page for Java fournit un modèle d’objet hautes performances XmpHeaderConverter et XmpMetadata permettant d’extraire les métadonnées XMP existantes ou d’injecter de nouvelles propriétés dans les fichiers EPS/PS.
- Pour lire des informations telles que les détails de l’auteur, les dates de création, les mentions de droits d’auteur et les attributs personnalisés à partir de fichiers EPS, utilisez la méthode
XmpMetadata.get(). - Pour modifier les champs de métadonnées existants tels que les titres de documents ou l’historique des modifications, utilisez la méthode
XmpMetadata.set(). - Pour ajouter des attributs de métadonnées propriétaires et spécifiques à l’entreprise aux fichiers graphiques, utilisez la méthode
XmpMetadata.registerNamespace().
Lecture des métadonnées XMP existantes à partir d’un fichier EPS
Extrayez et analysez les propriétés XMP standard et définies par l’utilisateur d’un document EPS afin d’inspecter des champs de métadonnées tels que dc:title, xmp:CreatorTool et xmp:CreateDate.
// Get XMP metadata from EPS document.
// Learn more: https://docs.aspose.com/page/java/working-with-xm-metadata-in-eps/
// Create PsDocument instance from file
PsDocument document = new PsDocument(getDataDir() + "get_input.eps");
// Get XMP metadata. If EPS file doesn't contain XMP metadata we get new one filled with values from PS metadata comments (%%Creator, %%CreateDate, %%Title etc)
XmpMetadata xmp = document.getXmpMetadata();
// Get "CreatorTool" value
if (xmp.containsKey("xmp:CreatorTool"))
System.out.println("CreatorTool: " + xmp.get("xmp:CreatorTool").toStringValue());
// Get "CreateDate" value
if (xmp.containsKey("xmp:CreateDate"))
System.out.println("CreateDate: " + xmp.get("xmp:CreateDate").toStringValue());
// Get a width of a thumbnail image if exists
if (xmp.containsKey("xmp:Thumbnails") && xmp.get("xmp:Thumbnails").isArray()) {
XmpValue val = xmp.get("xmp:Thumbnails").toArray()[0];
if (val.isNamedValues() && val.toDictionary().containsKey("xmpGImg:width"))
System.out.println("Thumbnail Width: " + val.toDictionary().get("xmpGImg:width").toInteger());
}
// Get "format" value
if (xmp.containsKey("dc:format"))
System.out.println("Format: " + xmp.get("dc:format").toStringValue());
// Get "DocumentID" value
if (xmp.containsKey("xmpMM:DocumentID"))
System.out.println("DocumentID: " + xmp.get("xmpMM:DocumentID").toStringValue());Ajout et injection de nouvelles métadonnées XMP dans un fichier EPS
Injectez des propriétés de métadonnées standard (telles que les schémas Dublin Core ou XMP Basic) dans un document EPS et enregistrez le fichier mis à jour.
// Add XMP metadata to EPS document.
// Learn more: https://docs.aspose.com/page/java/working-with-xm-metadata-in-eps/
// Initialize EPS file input stream
try (FileInputStream psStream = new FileInputStream(getDataDir() + "add_input.eps")) {
// Create PsDocument instance from stream. Given EPS file doesn't contain XMP metadata, but usual metadata does contain.
PsDocument document = new PsDocument(psStream);
String outputFileName = "add_xmp_metadata_out.eps";
XmpMetadata xmp = null;
try {
// Get XMP metadata. If EPS file doesn't contain XMP metadata we get new one filled with values from PS metadata comments (%%Creator, %%CreateDate, %%Title etc)
xmp = document.getXmpMetadata();
// Check metadata values extracted from PS metadata comments and set up in new XMP metadata
// Get "CreatorTool" value
if (xmp.containsKey("xmp:CreatorTool"))
System.out.println("CreatorTool: " + xmp.get("xmp:CreatorTool").toStringValue());
// Get "CreateDate" value
if (xmp.containsKey("xmp:CreateDate"))
System.out.println("CreateDate: " + xmp.get("xmp:CreateDate").toStringValue());
// Get "format" value
if (xmp.containsKey("dc:format"))
System.out.println("Format: " + xmp.get("dc:format").toStringValue());
// Get "title" value
if (xmp.containsKey("dc:title"))
System.out.println("Title: " + xmp.get("dc:title").toArray()[0].toStringValue());
// Get "creator" value
if (xmp.containsKey("dc:creator"))
System.out.println("Creator: " + xmp.get("dc:creator").toArray()[0].toStringValue());
// Get "MetadataDate" value
if (xmp.containsKey("xmp:MetadataDate"))
System.out.println("MetadataDate: " + xmp.get("xmp:MetadataDate").toStringValue());
// Update MetadataDate value
Date metadataDate = xmp.get("xmp:MetadataDate").toDateTime();
// Save EPS file with new XMP metadata
// Create ouput stream
try (FileOutputStream outPsStream = new FileOutputStream(getOutputDir() + outputFileName)) {
// Save EPS file
document.save(outPsStream);
}
} catch (IOException ex) {
}Ajout d’espaces de noms personnalisés nommés et de métadonnées de tableaux
Enregistrez des espaces de noms XML spécifiques à l’entreprise et stockez des types de données complexes, tels que des listes de tableaux, dans la structure XMP du document.
// Add namespace in XMP metadata in EPS document.
// Learn more: https://docs.aspose.com/page/java/working-with-xm-metadata-in-eps/
// Initialize EPS file input stream
try (FileInputStream psStream = new FileInputStream(getDataDir() + "add_simple_props_input.eps")) {
// Create PsDocument instance from stream
PsDocument document = new PsDocument(psStream);
String outputFileName = "add_xmp_namespace_out.eps";
try {
// Get XMP metadata. If EPS file doesn't contain XMP metadata we get new one filled with values from PS metadata comments (%%Creator, %%CreateDate, %%Title etc)
XmpMetadata xmp = document.getXmpMetadata();
//Change XMP metadata values
// Add new XML namespace "tmp".
xmp.registerNamespaceURI("tmp", "http://www.some.org/schema/tmp#");
// Add new string property in new namespace.
xmp.put("tmp:newKey", new XmpValue("NewValue"));
// Save EPS file with changed XMP metadata
// Create ouput stream
try (FileOutputStream outPsStream = new FileOutputStream(getOutputDir() + outputFileName)) {
// Save EPS file
document.save(outPsStream);
}
} catch (IOException ex) {
}Installation et configuration
Ajoutez Aspose.Page for Java à votre Maven :
Package Manager Console Command
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-page</artifactId>
<version>Latest</version>
</dependency>
FAQ
1. Puis-je extraire les métadonnées XMP d’un fichier EPS qui ne contient pas d’en-tête XMP standard ?
Si un fichier EPS ne contient pas de paquet d’en-tête XMP existant, PsDocument.getXmpMetadata() renvoie une structure XmpMetadata vide. Vous pouvez la remplir avec des propriétés et appeler document.save() pour écrire un nouveau paquet XMP valide dans le fichier.
2. Quels schémas XMP standard sont pris en charge par Aspose.Page for Java ?
Aspose.Page prend nativement en charge tous les schémas XMP standard, notamment Dublin Core (dc:), XMP Basic (xmp:), XMP Rights Management (xmpRights:), XMP Media Management (xmpMM:) et le schéma Adobe PDF (pdf:).
3. La mise à jour des métadonnées XMP réencode-t-elle ou dégrade-t-elle les graphiques visuels EPS ?
Non. Aspose.Page modifie ou insère le bloc de métadonnées d’en-tête XMP situé dans le préambule du document sans modifier ni recompresser les formes vectorielles, les graphiques raster ou le code PostScript.