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