قراءة وإضافة بيانات XMP الوصفية في مستندات EPS/PS باستخدام Java

استخراج بيانات XMP (منصة البيانات الوصفية القابلة للتوسعة)، وفحصها وإضافتها وتحديثها في مستندات 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>

الأسئلة الشائعة

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 البرمجية أو إعادة ضغطها.