org.apache.tika.xmp

Class XMPMetadata

java.lang.Object

org.apache.tika.metadata.Metadata

org.apache.tika.xmp.XMPMetadata

All Implemented Interfaces:

Serializable, org.apache.tika.metadata.ClimateForcast, org.apache.tika.metadata.CreativeCommons, org.apache.tika.metadata.Geographic, org.apache.tika.metadata.HttpHeaders, org.apache.tika.metadata.Message, org.apache.tika.metadata.MSOffice, org.apache.tika.metadata.TIFF, org.apache.tika.metadata.TikaMetadataKeys, org.apache.tika.metadata.TikaMimeKeys

public class XMPMetadata
extends org.apache.tika.metadata.Metadata

Provides a conversion of the Metadata map from Tika to the XMP data model by also providing the Metadata API for clients to ease transition. But clients can also work directly on the XMP data model, by getting the XMPMeta reference from this class. Usually the instance would be initialized by providing the Metadata object that had been returned from Tika-core which populates the XMP data model with all properties that can be converted. This class is not serializable!

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.tika.metadata.Metadata

CONTRIBUTOR, COVERAGE, CREATOR, DATE, DESCRIPTION, FORMAT, IDENTIFIER, LANGUAGE, MODIFIED, NAMESPACE_PREFIX_DELIMITER, PUBLISHER, RELATION, RIGHTS, SOURCE, SUBJECT, TITLE, TYPE

Fields inherited from interface org.apache.tika.metadata.CreativeCommons

LICENSE_LOCATION, LICENSE_URL, WORK_TYPE

Fields inherited from interface org.apache.tika.metadata.Geographic

ALTITUDE, LATITUDE, LONGITUDE

Fields inherited from interface org.apache.tika.metadata.HttpHeaders

CONTENT_DISPOSITION, CONTENT_ENCODING, CONTENT_LANGUAGE, CONTENT_LENGTH, CONTENT_LOCATION, CONTENT_MD5, CONTENT_TYPE, LAST_MODIFIED, LOCATION

Fields inherited from interface org.apache.tika.metadata.Message

MESSAGE_BCC, MESSAGE_BCC_DISPLAY_NAME, MESSAGE_BCC_EMAIL, MESSAGE_BCC_NAME, MESSAGE_CC, MESSAGE_CC_DISPLAY_NAME, MESSAGE_CC_EMAIL, MESSAGE_CC_NAME, MESSAGE_FROM, MESSAGE_FROM_EMAIL, MESSAGE_FROM_NAME, MESSAGE_PREFIX, MESSAGE_RAW_HEADER_PREFIX, MESSAGE_RECIPIENT_ADDRESS, MESSAGE_TO, MESSAGE_TO_DISPLAY_NAME, MESSAGE_TO_EMAIL, MESSAGE_TO_NAME, MULTIPART_BOUNDARY, MULTIPART_SUBTYPE

Fields inherited from interface org.apache.tika.metadata.MSOffice

APPLICATION_NAME, APPLICATION_VERSION, AUTHOR, CATEGORY, CHARACTER_COUNT, CHARACTER_COUNT_WITH_SPACES, COMMENTS, COMPANY, CONTENT_STATUS, CREATION_DATE, EDIT_TIME, IMAGE_COUNT, KEYWORDS, LAST_AUTHOR, LAST_PRINTED, LAST_SAVED, LINE_COUNT, MANAGER, NOTES, OBJECT_COUNT, PAGE_COUNT, PARAGRAPH_COUNT, PRESENTATION_FORMAT, REVISION_NUMBER, SECURITY, SLIDE_COUNT, TABLE_COUNT, TEMPLATE, TOTAL_TIME, USER_DEFINED_METADATA_NAME_PREFIX, VERSION, WORD_COUNT

Fields inherited from interface org.apache.tika.metadata.ClimateForcast

ACKNOWLEDGEMENT, COMMAND_LINE, COMMENT, CONTACT, CONVENTIONS, EXPERIMENT_ID, HISTORY, INSTITUTION, MODEL_NAME_ENGLISH, PROGRAM_ID, PROJECT_ID, REALIZATION, REFERENCES, TABLE_ID

Fields inherited from interface org.apache.tika.metadata.TIFF

BITS_PER_SAMPLE, EQUIPMENT_MAKE, EQUIPMENT_MODEL, EXIF_PAGE_COUNT, EXPOSURE_TIME, F_NUMBER, FLASH_FIRED, FOCAL_LENGTH, IMAGE_LENGTH, IMAGE_WIDTH, ISO_SPEED_RATINGS, ORIENTATION, ORIGINAL_DATE, RESOLUTION_HORIZONTAL, RESOLUTION_UNIT, RESOLUTION_VERTICAL, SAMPLES_PER_PIXEL, SOFTWARE

Fields inherited from interface org.apache.tika.metadata.TikaMetadataKeys

EMBEDDED_RELATIONSHIP_ID, EMBEDDED_RESOURCE_TYPE, EMBEDDED_STORAGE_CLASS_ID, PROTECTED, RESOURCE_NAME_KEY

Fields inherited from interface org.apache.tika.metadata.TikaMimeKeys

MIME_TYPE_MAGIC, TIKA_MIME_FILE

Constructor Summary

Constructors

Constructor and Description
XMPMetadata() Initializes with an empty XMP packet
XMPMetadata(org.apache.tika.metadata.Metadata meta)
XMPMetadata(org.apache.tika.metadata.Metadata meta, String mimetype) Initializes the data by converting the Metadata information to XMP.

Method Summary

Modifier and Type	Method and Description
void	add(String name, String value) As this API could only possibly work for simple properties in XMP, it just calls the set method, which replaces any existing value
static void	deleteNamespace(String namespaceURI) Deletes a namespace from the registry.
boolean	equals(Object o) This method is not implemented, yet.
String	get(org.apache.tika.metadata.Property property)
String	get(String name) Returns the value of a simple property or the first one of an array.
Date	getDate(org.apache.tika.metadata.Property property)
Integer	getInt(org.apache.tika.metadata.Property property)
static String	getNamespacePrefix(String namespaceURI) Obtain the prefix for a registered namespace URI.
static Map<String,String>	getNamespaces()
static String	getNamespaceURI(String namespacePrefix) Obtain the URI for a registered namespace prefix.
static Map<String,String>	getPrefixes()
String[]	getValues(org.apache.tika.metadata.Property property)
String[]	getValues(String name) Returns the value of a simple property or all if the property is an array and the elements are of simple type.
com.adobe.xmp.XMPMeta	getXMPData() Provides direct access to the XMP data model, in case a client prefers to work directly on it instead of using the Metadata API
boolean	isMultiValued(org.apache.tika.metadata.Property property)
boolean	isMultiValued(String name) Checks if the named property is an array.
String[]	names() For XMP it is not clear what that API should return, therefor not implemented
void	process(org.apache.tika.metadata.Metadata meta)
void	process(org.apache.tika.metadata.Metadata meta, String mimetype) Converts the Metadata information to XMP.
static String	registerNamespace(String namespaceURI, String suggestedPrefix) Register a namespace URI with a suggested prefix.
void	remove(org.apache.tika.metadata.Property property)
void	remove(String name) Removes the given property from the XMP data.
void	set(org.apache.tika.metadata.Property property, Date date)
void	set(org.apache.tika.metadata.Property property, double value)
void	set(org.apache.tika.metadata.Property property, int value)
void	set(org.apache.tika.metadata.Property property, String value)
void	set(org.apache.tika.metadata.Property property, String[] values) Sets array properties.
void	set(String name, String value) Sets the given property.
void	setAll(Properties properties) It will set all simple and array properties that have QName keys in registered namespaces.
int	size() Returns the number of top-level namespaces
String	toString() Serializes the XMP data in compact form without packet wrapper

Methods inherited from class org.apache.tika.metadata.Metadata

add, hashCode, set

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

XMPMetadata

public XMPMetadata()

Initializes with an empty XMP packet

XMPMetadata

public XMPMetadata(org.apache.tika.metadata.Metadata meta)
            throws org.apache.tika.exception.TikaException

Throws:

org.apache.tika.exception.TikaException

See Also:

But the mimetype is retrieved from the metadata map.

XMPMetadata

public XMPMetadata(org.apache.tika.metadata.Metadata meta,
                   String mimetype)
            throws org.apache.tika.exception.TikaException

Initializes the data by converting the Metadata information to XMP. If a mimetype is provided, a specific converter can be used, that converts all available metadata. If there is no mimetype provided or no specific converter available a generic conversion is done which will convert only those properties that are in known namespaces and are using the correct prefixes

Parameters:

meta - the Metadata information from Tika-core

mimetype - mimetype information

Throws:

In - case an error occured during conversion

org.apache.tika.exception.TikaException

Method Detail

process

public void process(org.apache.tika.metadata.Metadata meta)
             throws org.apache.tika.exception.TikaException

Throws:

org.apache.tika.exception.TikaException

See Also:

But the mimetype is retrieved from the metadata map.

process

public void process(org.apache.tika.metadata.Metadata meta,
                    String mimetype)
             throws org.apache.tika.exception.TikaException

Converts the Metadata information to XMP. If a mimetype is provided, a specific converter can be used, that converts all available metadata. If there is no mimetype provided or no specific converter available a generic conversion is done which will convert only those properties that are in known namespaces and are using the correct prefixes

Parameters:

meta - the Metadata information from Tika-core

mimetype - mimetype information

Throws:

In - case an error occured during conversion

org.apache.tika.exception.TikaException

getXMPData

public com.adobe.xmp.XMPMeta getXMPData()

Provides direct access to the XMP data model, in case a client prefers to work directly on it instead of using the Metadata API

Returns:

the "internal" XMP data object

registerNamespace

public static String registerNamespace(String namespaceURI,
                                       String suggestedPrefix)
                                throws com.adobe.xmp.XMPException

Register a namespace URI with a suggested prefix. It is not an error if the URI is already registered, no matter what the prefix is. If the URI is not registered but the suggested prefix is in use, a unique prefix is created from the suggested one. The actual registeed prefix is always returned. The function result tells if the registered prefix is the suggested one. Note: No checking is presently done on either the URI or the prefix.

Parameters:

namespaceURI - The URI for the namespace. Must be a valid XML URI.

suggestedPrefix - The suggested prefix to be used if the URI is not yet registered. Must be a valid XML name.

Returns:

Returns the registered prefix for this URI, is equal to the suggestedPrefix if the namespace hasn't been registered before, otherwise the existing prefix.

Throws:

com.adobe.xmp.XMPException - If the parameters are not accordingly set

getNamespacePrefix

public static String getNamespacePrefix(String namespaceURI)

Obtain the prefix for a registered namespace URI. It is not an error if the namespace URI is not registered.

Parameters:

namespaceURI - The URI for the namespace. Must not be null or the empty string.

Returns:

Returns the prefix registered for this namespace URI or null.

getNamespaceURI

public static String getNamespaceURI(String namespacePrefix)

Obtain the URI for a registered namespace prefix. It is not an error if the namespace prefix is not registered.

Parameters:

namespacePrefix - The prefix for the namespace. Must not be null or the empty string.

Returns:

Returns the URI registered for this prefix or null.

getNamespaces

public static Map<String,String> getNamespaces()

Returns:

Returns the registered prefix/namespace-pairs as map, where the keys are the namespaces and the values are the prefixes.

getPrefixes

public static Map<String,String> getPrefixes()

Returns:

Returns the registered namespace/prefix-pairs as map, where the keys are the prefixes and the values are the namespaces.

deleteNamespace

public static void deleteNamespace(String namespaceURI)

Deletes a namespace from the registry.

Does nothing if the URI is not registered, or if the namespaceURI parameter is null or the empty string.

Note: Not yet implemented.

Parameters:

namespaceURI - The URI for the namespace.

isMultiValued

public boolean isMultiValued(org.apache.tika.metadata.Property property)

Overrides:

isMultiValued in class org.apache.tika.metadata.Metadata

See Also:

isMultiValued(java.lang.String)

isMultiValued

public boolean isMultiValued(String name)

Checks if the named property is an array.

Overrides:

isMultiValued in class org.apache.tika.metadata.Metadata

See Also:

Metadata.isMultiValued(java.lang.String)

names

public String[] names()

For XMP it is not clear what that API should return, therefor not implemented

Overrides:

names in class org.apache.tika.metadata.Metadata

get

public String get(String name)

Returns the value of a simple property or the first one of an array. The given name must contain a namespace prefix of a registered namespace.

Overrides:

get in class org.apache.tika.metadata.Metadata

See Also:

Metadata.get(java.lang.String)

get

public String get(org.apache.tika.metadata.Property property)

Overrides:

get in class org.apache.tika.metadata.Metadata

See Also:

get(java.lang.String)

getInt

public Integer getInt(org.apache.tika.metadata.Property property)

Overrides:

getInt in class org.apache.tika.metadata.Metadata

See Also:

get(java.lang.String)

getDate

public Date getDate(org.apache.tika.metadata.Property property)

Overrides:

getDate in class org.apache.tika.metadata.Metadata

See Also:

get(java.lang.String)

getValues

public String[] getValues(org.apache.tika.metadata.Property property)

Overrides:

getValues in class org.apache.tika.metadata.Metadata

See Also:

getValues(java.lang.String)

getValues

public String[] getValues(String name)

Returns the value of a simple property or all if the property is an array and the elements are of simple type. The given name must contain a namespace prefix of a registered namespace.

Overrides:

getValues in class org.apache.tika.metadata.Metadata

See Also:

Metadata.getValues(java.lang.String)

add

public void add(String name,
                String value)

As this API could only possibly work for simple properties in XMP, it just calls the set method, which replaces any existing value

Overrides:

add in class org.apache.tika.metadata.Metadata

See Also:

Metadata.add(java.lang.String, java.lang.String)

set

public void set(String name,
                String value)

Sets the given property. If the property already exists, it is overwritten. Only simple properties that use a registered prefix are stored in the XMP.

Overrides:

set in class org.apache.tika.metadata.Metadata

See Also:

Metadata.set(java.lang.String, java.lang.String)

set

public void set(org.apache.tika.metadata.Property property,
                String value)

Overrides:

set in class org.apache.tika.metadata.Metadata

See Also:

set(java.lang.String, java.lang.String)

set

public void set(org.apache.tika.metadata.Property property,
                int value)

Overrides:

set in class org.apache.tika.metadata.Metadata

See Also:

set(java.lang.String, java.lang.String)

set

public void set(org.apache.tika.metadata.Property property,
                double value)

Overrides:

set in class org.apache.tika.metadata.Metadata

See Also:

set(java.lang.String, java.lang.String)

set

public void set(org.apache.tika.metadata.Property property,
                Date date)

Overrides:

set in class org.apache.tika.metadata.Metadata

See Also:

set(java.lang.String, java.lang.String)

set

public void set(org.apache.tika.metadata.Property property,
                String[] values)

Sets array properties. If the property already exists, it is overwritten. Only array properties that use a registered prefix are stored in the XMP.

Overrides:

set in class org.apache.tika.metadata.Metadata

See Also:

Metadata.set(org.apache.tika.metadata.Property, java.lang.String[])

setAll

public void setAll(Properties properties)

It will set all simple and array properties that have QName keys in registered namespaces.

Overrides:

setAll in class org.apache.tika.metadata.Metadata

See Also:

Metadata.setAll(java.util.Properties)

remove

public void remove(org.apache.tika.metadata.Property property)

See Also:

remove(java.lang.String)

remove

public void remove(String name)

Removes the given property from the XMP data. If it is a complex property the whole subtree is removed

Overrides:

remove in class org.apache.tika.metadata.Metadata

See Also:

Metadata.remove(java.lang.String)

size

public int size()

Returns the number of top-level namespaces

Overrides:

size in class org.apache.tika.metadata.Metadata

equals

public boolean equals(Object o)

This method is not implemented, yet. It is very tedious to check for semantic equality of XMP packets

Overrides:

equals in class org.apache.tika.metadata.Metadata

toString

public String toString()

Serializes the XMP data in compact form without packet wrapper

Overrides:

toString in class org.apache.tika.metadata.Metadata

See Also:

Metadata.toString()