org.apache.jempbox.xmp

Class XMPMetadata

public class XMPMetadata extends Object

This class represents the top level XMP data structure and gives access to the various schemas that are available as part of the XMP specification.

Version: $Revision: 1.10 $

Author: Ben Litchfield

Field Summary
protected String	encoding The encoding of the XMP document.
static String	ENCODING_UTF16BE Supported encoding for persisted XML.
static String	ENCODING_UTF16LE Supported encoding for persisted XML.
static String	ENCODING_UTF8 Supported encoding for persisted XML.
protected Map	nsMappings A mapping of namespaces.
protected Document	xmpDocument The DOM representation of the metadata.

Constructor Summary
	XMPMetadata() Default constructor, creates blank XMP doc.
	XMPMetadata(Document doc) Constructor from an existing XML document.

Method Summary
XMPSchemaBasicJobTicket	addBasicJobTicketSchema() Add a new Job Ticket schema.
XMPSchemaBasic	addBasicSchema() Create and add a new Basic Schema to this metadata.
XMPSchemaDublinCore	addDublinCoreSchema() Create and add a new Dublin Core Schema to this metadata.
XMPSchemaDynamicMedia	addDynamicMediaSchema() Add a new Dynamic Media schema.
XMPSchemaIptc4xmpCore	addIptc4xmpCoreSchema() Create and add a new IPTC schema to this metadata.
XMPSchemaMediaManagement	addMediaManagementSchema() Add a new Media Management schema.
XMPSchemaPagedText	addPagedTextSchema() Add a new Paged Text schema.
XMPSchemaPDF	addPDFSchema() Create and add a new PDF Schema to this metadata.
XMPSchemaPhotoshop	addPhotoshopSchema() Create and add a new Photoshop schema to this metadata.
XMPSchemaRightsManagement	addRightsManagementSchema() Add a new Rights Managment schema.
void	addSchema(XMPSchema schema) Add a custom schema to the root rdf.
void	addXMLNSMapping(String namespace, Class xmpSchema) Will add a XMPSchema to the set of identified schemas.
byte[]	asByteArray() Get the XML document as a byte array.
protected XMPSchema	basicAddSchema(XMPSchema schema) Generic add schema method.
XMPSchemaBasicJobTicket	getBasicJobTicketSchema() Get the Job Ticket Schema.
XMPSchemaBasic	getBasicSchema() Get the Basic Schema.
XMPSchemaDublinCore	getDublinCoreSchema() Get the Dublin Core Schema.
XMPSchemaDynamicMedia	getDynamicMediaSchema() Get the Dynamic Media Schema.
String	getEncoding() Get the current encoding that will be used to write the XML.
XMPSchemaMediaManagement	getMediaManagementSchema() Get the Media Management Schema.
XMPSchemaPagedText	getPagedTextSchema() Get the Paged Text Schema.
XMPSchemaPDF	getPDFSchema() Get the PDF Schema.
XMPSchemaRightsManagement	getRightsManagementSchema() Get the Schema Rights Schema.
XMPSchema	getSchemaByClass(Class targetSchema) Tries to retrieve a schema from this by classname.
List	getSchemas() This will get a list of XMPSchema(or subclass) objects.
List	getSchemasByNamespaceURI(String namespaceURI) Will return all schemas that fit the given namespaceURI.
Document	getXMPDocument() Get the XML document from this object.
boolean	hasUnknownSchema() This will return true if the XMP contains an unknown schema.
static XMPMetadata	load(String file) Load metadata from the filesystem.
static XMPMetadata	load(InputSource is) Load a schema from an input source.
static XMPMetadata	load(InputStream is) Load metadata from the filesystem.
static void	main(String[] args) Test main program.
void	merge(XMPMetadata metadata) Merge this metadata with the given metadata object.
void	save(String file) Save the XMP document to a file.
void	save(OutputStream outStream) Save the XMP document to a stream.
void	setEncoding(String xmlEncoding) The encoding used to write the XML.

Field Detail

encoding

protected String encoding

The encoding of the XMP document. Default is UTF8.

ENCODING_UTF16BE

public static final String ENCODING_UTF16BE

Supported encoding for persisted XML.

ENCODING_UTF16LE

public static final String ENCODING_UTF16LE

Supported encoding for persisted XML.

ENCODING_UTF8

public static final String ENCODING_UTF8

Supported encoding for persisted XML.

nsMappings

protected Map nsMappings

A mapping of namespaces.

xmpDocument

protected Document xmpDocument

The DOM representation of the metadata.

Constructor Detail

XMPMetadata

public XMPMetadata()

Default constructor, creates blank XMP doc.

Throws: IOException If there is an error creating the initial document.

XMPMetadata

public XMPMetadata(Document doc)

Constructor from an existing XML document.

Parameters: doc The root XMP document.

Method Detail

addBasicJobTicketSchema

public XMPSchemaBasicJobTicket addBasicJobTicketSchema()

Add a new Job Ticket schema.

Returns: The newly added schema.

Create and add a new Basic Schema to this metadata. Typically a XMP document will only have one schema for each type (but multiple are supported) so it is recommended that you first check the existence of a this scheme by using getDublinCoreSchema()

Returns: A new blank PDF schema that is now part of the metadata.

addDublinCoreSchema

public XMPSchemaDublinCore addDublinCoreSchema()

Create and add a new Dublin Core Schema to this metadata. Typically a XMP document will only have one schema for each type (but multiple are supported) so it is recommended that you first check the existence of a this scheme by using getDublinCoreSchema()

Returns: A new blank PDF schema that is now part of the metadata.

addDynamicMediaSchema

public XMPSchemaDynamicMedia addDynamicMediaSchema()

Add a new Dynamic Media schema.

Returns: The newly added schema.

addIptc4xmpCoreSchema

public XMPSchemaIptc4xmpCore addIptc4xmpCoreSchema()

Create and add a new IPTC schema to this metadata.

Returns: A new blank IPTC schema that is now part of the metadata.

addMediaManagementSchema

public XMPSchemaMediaManagement addMediaManagementSchema()

Add a new Media Management schema.

Returns: The newly added schema.

addPagedTextSchema

public XMPSchemaPagedText addPagedTextSchema()

Add a new Paged Text schema.

Returns: The newly added schema.

addPDFSchema

public XMPSchemaPDF addPDFSchema()

Create and add a new PDF Schema to this metadata. Typically a XMP document will only have one PDF schema (but multiple are supported) so it is recommended that you first check the existence of a PDF scheme by using getPDFSchema()

Returns: A new blank PDF schema that is now part of the metadata.

addPhotoshopSchema

public XMPSchemaPhotoshop addPhotoshopSchema()

Create and add a new Photoshop schema to this metadata.

Returns: A new blank Photoshop schema that is now part of the metadata.

addRightsManagementSchema

public XMPSchemaRightsManagement addRightsManagementSchema()

Add a new Rights Managment schema.

Returns: The newly added schema.

addSchema

public void addSchema(XMPSchema schema)

Add a custom schema to the root rdf. The schema has to have been created as a child of this XMPMetadata.

Parameters: schema The schema to add.

addXMLNSMapping

public void addXMLNSMapping(String namespace, Class xmpSchema)

Will add a XMPSchema to the set of identified schemas. The class needs to have a constructor with parameter Element

Parameters: namespace The namespace URI of the schmema for instance http://purl.org/dc/elements/1.1/. xmpSchema The schema to associated this identifier with.

asByteArray

public byte[] asByteArray()

Get the XML document as a byte array.

Returns: The metadata as an XML byte stream.

Throws: Exception If there is an error creating the stream.

basicAddSchema

protected XMPSchema basicAddSchema(XMPSchema schema)

Generic add schema method.

Parameters: schema The schema to add.

Returns: The newly added schema.

getBasicJobTicketSchema

public XMPSchemaBasicJobTicket getBasicJobTicketSchema()

Get the Job Ticket Schema.

Returns: The first Job Ticket schema in the list.

Throws: IOException If there is an error accessing the schema.

getBasicSchema

public XMPSchemaBasic getBasicSchema()

Get the Basic Schema.

Returns: The first Basic schema in the list.

Throws: IOException If there is an error accessing the schema.

getDublinCoreSchema

public XMPSchemaDublinCore getDublinCoreSchema()

Get the Dublin Core Schema.

Returns: The first Dublin schema in the list.

Throws: IOException If there is an error accessing the schema.

getDynamicMediaSchema

public XMPSchemaDynamicMedia getDynamicMediaSchema()

Get the Dynamic Media Schema.

Returns: The first Dynamic Media schema in the list.

Throws: IOException If there is an error accessing the schema.

getEncoding

public String getEncoding()

Get the current encoding that will be used to write the XML.

Returns: The current encoding to write the XML to.

getMediaManagementSchema

public XMPSchemaMediaManagement getMediaManagementSchema()

Get the Media Management Schema.

Returns: The first Media Management schema in the list.

Throws: IOException If there is an error accessing the schema.

getPagedTextSchema

public XMPSchemaPagedText getPagedTextSchema()

Get the Paged Text Schema.

Returns: The first Paged Text schema in the list.

Throws: IOException If there is an error accessing the schema.

getPDFSchema

public XMPSchemaPDF getPDFSchema()

Get the PDF Schema.

Returns: The first PDF schema in the list.

Throws: IOException If there is an error accessing the schema.

getRightsManagementSchema

public XMPSchemaRightsManagement getRightsManagementSchema()

Get the Schema Rights Schema.

Returns: The first Schema Rights schema in the list.

Throws: IOException If there is an error accessing the schema.

getSchemaByClass

public XMPSchema getSchemaByClass(Class targetSchema)

Tries to retrieve a schema from this by classname.

Parameters: targetSchema Class for targetSchema.

Returns: XMPSchema or null if no target is found.

Throws: IOException if there was an error creating the schemas of this.

getSchemas

public List getSchemas()

This will get a list of XMPSchema(or subclass) objects.

Returns: A non null read-only list of schemas that are part of this metadata.

Throws: IOException If there is an error creating a specific schema.

getSchemasByNamespaceURI

public List getSchemasByNamespaceURI(String namespaceURI)

Will return all schemas that fit the given namespaceURI. Which is only done by using the namespace mapping (nsMapping) and not by actually checking the xmlns property.

Parameters: namespaceURI The namespaceURI to filter for.

Returns: A list containing the found schemas or an empty list if non are found or the namespaceURI could not be found in the namespace mapping.

Throws: IOException If an operation on the document fails.