Membaca dan menambahkan metadata XMP dalam dokumen EPS/PS dengan Java
Ekstrak, periksa, tambahkan, dan perbarui metadata XMP (Extensible Metadata Platform) dalam dokumen EPS dan PostScript (PS) menggunakan Aspose.Page for Java. Sematkan properti Dublin Core standar, statistik pembuatan dokumen, detail hak cipta, dan struktur metadata kustom langsung ke aliran file PostScript tanpa mengubah konten visual grafik vektor yang mendasarinya.
Aspose.Page for Java menyediakan model objek XmpHeaderConverter dan XmpMetadata berkinerja tinggi untuk mengekstrak metadata XMP yang ada atau menyisipkan properti baru ke dalam file EPS/PS.
- Untuk membaca informasi seperti detail penulis, tanggal pembuatan, pemberitahuan hak cipta, dan atribut kustom dari file EPS, gunakan metode
XmpMetadata.get(). - Untuk mengedit bidang metadata yang ada seperti judul dokumen atau riwayat modifikasi, gunakan metode
XmpMetadata.set(). - Untuk menambahkan atribut metadata proprietari dan khusus perusahaan ke file grafik, gunakan metode
XmpMetadata.registerNamespace().
Membaca metadata XMP yang ada dari File EPS
Ekstrak dan uraikan properti XMP standar dan yang ditentukan pengguna dari dokumen EPS untuk memeriksa bidang metadata seperti dc:title, xmp:CreatorTool, dan 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());Menambahkan dan menyisipkan metadata XMP baru ke dalam File EPS
Sisipkan properti metadata standar (seperti skema Dublin Core atau XMP Basic) ke dalam dokumen EPS dan simpan output file yang telah diperbarui.
// 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) {
}Menambahkan namespace bernama kustom dan metadata array
Daftarkan namespace XML khusus perusahaan dan simpan tipe data kompleks, seperti daftar array, di dalam struktur XMP dokumen.
// 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) {
}Instalasi dan Penyiapan
Tambahkan Aspose.Page for Java ke Maven Anda:
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. Bisakah saya mengekstrak metadata XMP dari file EPS yang tidak berisi header XMP standar?
Jika file EPS tidak memiliki paket header XMP yang sudah ada, PsDocument.getXmpMetadata() mengembalikan struktur XmpMetadata kosong. Anda dapat mengisinya dengan properti dan memanggil document.save() untuk menulis paket XMP baru yang valid ke file.
2. Skema XMP standar apa saja yang didukung oleh Aspose.Page for Java?
Aspose.Page secara native mendukung semua skema XMP standar, termasuk Dublin Core (dc:), XMP Basic (xmp:), XMP Rights Management (xmpRights:), XMP Media Management (xmpMM:), dan skema Adobe PDF (pdf:).
3. Apakah memperbarui metadata XMP akan melakukan encoding ulang atau menurunkan kualitas grafis visual EPS?
Tidak. Aspose.Page memodifikasi atau menyisipkan blok metadata header XMP yang terletak di preambule dokumen tanpa mengubah atau mengompresi ulang bentuk vektor, grafis raster, atau kode PostScript.