Leitura e adição de metadados XMP em documentos EPS/PS com Java
Extraia, inspecione, adicione e atualize metadados XMP (Extensible Metadata Platform) em documentos EPS e PostScript (PS) usando o Aspose.Page for Java. Incorpore propriedades Dublin Core padrão, estatísticas de criação do documento, detalhes de direitos autorais e estruturas de metadados personalizadas diretamente nos fluxos de arquivos PostScript sem alterar o conteúdo visual subjacente dos gráficos vetoriais.
O Aspose.Page for Java fornece um modelo de objetos de alto desempenho XmpHeaderConverter e XmpMetadata para extrair metadados XMP existentes ou inserir novas propriedades em arquivos EPS/PS.
- Para ler informações como detalhes do autor, datas de criação, avisos de direitos autorais e atributos personalizados de arquivos EPS, use o método
XmpMetadata.get(). - Para editar campos de metadados existentes, como títulos de documentos ou histórico de modificações, use o método
XmpMetadata.set(). - Para adicionar atributos de metadados proprietários e específicos da empresa a arquivos gráficos, use o método
XmpMetadata.registerNamespace().
Leitura de metadados XMP existentes de um arquivo EPS
Extraia e analise propriedades XMP padrão e definidas pelo usuário de um documento EPS para inspecionar campos de metadados como dc:title, xmp:CreatorTool e 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());Adição e inserção de novos metadados XMP em um arquivo EPS
Insira propriedades de metadados padrão (como esquemas Dublin Core ou XMP Basic) em um documento EPS e salve o arquivo de saída atualizado.
// 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) {
}Adição de namespaces nomeados personalizados e metadados de matriz
Registre namespaces XML específicos da empresa e armazene tipos de dados complexos, como listas de matrizes, dentro da estrutura XMP do documento.
// 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) {
}Instalação e configuração
Adicione o Aspose.Page for Java ao seu 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. Posso extrair metadados XMP de um arquivo EPS que não contém um cabeçalho XMP padrão?
Se um arquivo EPS não tiver um pacote de cabeçalho XMP existente, PsDocument.getXmpMetadata() retornará uma estrutura XmpMetadata vazia. Você pode preenchê-la com propriedades e chamar document.save() para gravar um novo pacote XMP válido no arquivo.
2. Quais esquemas XMP padrão são compatíveis com o Aspose.Page for Java?
O Aspose.Page oferece suporte nativo a todos os esquemas XMP padrão, incluindo Dublin Core (dc:), XMP Basic (xmp:), XMP Rights Management (xmpRights:), XMP Media Management (xmpMM:) e o esquema Adobe PDF (pdf:).
3. A atualização dos metadados XMP reencoda ou degrada os gráficos visuais do EPS?
Não. O Aspose.Page modifica ou insere o bloco de metadados do cabeçalho XMP localizado no preâmbulo do documento sem alterar ou recomprimir formas vetoriais, gráficos rasterizados ou código PostScript.