Чтение и добавление метаданных 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.