Читання та додавання метаданих XMP у документах EPS/PS за допомогою Java
Видобувайте, перевіряйте, додавайте та оновлюйте метадані XMP (Extensible Metadata Platform) у документах EPS і PostScript (PS) за допомогою Aspose.Page for Java. Вбудовуйте стандартні властивості Dublin Core, статистику створення документа, відомості про авторські права та користувацькі структури метаданих безпосередньо в потоки файлів PostScript, не змінюючи базовий візуальний вміст векторної графіки.
Aspose.Page for Java надає високопродуктивну об’єктну модель XmpHeaderConverter і XmpMetadata для видобування наявних метаданих XMP або додавання нових властивостей до файлів EPS/PS.
- Щоб прочитати такі відомості, як дані про автора, дати створення, повідомлення про авторські права та користувацькі атрибути з файлів EPS, використовуйте метод
XmpMetadata.get(). - Щоб редагувати наявні поля метаданих, такі як заголовки документів або історія змін, використовуйте метод
XmpMetadata.set(). - Щоб додати до графічних файлів власні атрибути метаданих, специфічні для підприємства, використовуйте метод
XmpMetadata.registerNamespace().
Читання наявних метаданих XMP із файлу EPS
Видобувайте та аналізуйте стандартні й визначені користувачем властивості XMP з документа EPS, щоб перевірити такі поля метаданих, як dc:title, xmp:CreatorTool і 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());Додавання та вставлення нових метаданих XMP у файл EPS
Вставляйте стандартні властивості метаданих (наприклад, схеми Dublin Core або XMP Basic) у документ EPS і зберігайте оновлений файл.
// 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) {
}Додавання користувацьких іменованих просторів імен і метаданих масивів
Реєструйте XML-простори імен, специфічні для підприємства, і зберігайте складні типи даних, такі як списки масивів, у структурі XMP документа.
// 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) {
}Встановлення та налаштування
Додайте Aspose.Page for Java до свого 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. Чи можу я витягти метадані XMP із файлу EPS, який не містить стандартного заголовка XMP?
Якщо файл EPS не містить наявного пакета заголовка XMP, PsDocument.getXmpMetadata() повертає порожню структуру XmpMetadata. Ви можете заповнити її властивостями та викликати document.save(), щоб записати новий дійсний пакет XMP у файл.
2. Які стандартні схеми XMP підтримує Aspose.Page for Java?
Aspose.Page нативно підтримує всі стандартні схеми XMP, зокрема Dublin Core (dc:), XMP Basic (xmp:), XMP Rights Management (xmpRights:), XMP Media Management (xmpMM:) та схему Adobe PDF (pdf:).
3. Чи призводить оновлення метаданих XMP до повторного кодування або погіршення якості візуальної графіки EPS?
Ні. Aspose.Page змінює або додає блок метаданих заголовка XMP, розташований у преамбулі документа, не змінюючи та не повторно стискаючи векторні фігури, растрову графіку або код PostScript.