com.adobe.xmp.core.parser

Interface XMPParser

All Known Implementing Classes:

RDFXMLParser

public interface XMPParser

Interface for all kinds of parsers that create an XMP data model.

Method Summary

Modifier and Type	Method and Description
XMPMetadata	parse(byte[] input, java.util.Map<java.lang.String,java.lang.Object> parseContext) Parse XMP in RDF/XML form from a byte buffer.
XMPMetadata	parse(java.io.InputStream input, java.util.Map<java.lang.String,java.lang.Object> parseContext) Parse XMP in RDF/XML form from an InputStream.
XMPMetadata	parse(java.lang.String input, java.util.Map<java.lang.String,java.lang.Object> parseContext) Parse XMP in RDF/XML form from a String The parser will simply ignore sub-trees that contain invalid XMP data.

Method Detail

parse

XMPMetadata parse(java.io.InputStream input,
                  java.util.Map<java.lang.String,java.lang.Object> parseContext)
           throws XMPException

Parse XMP in RDF/XML form from an InputStream. The input for parsing may be any valid Unicode encoding, it is recognized automatically. The client has to open/close the stream. The parser will simply ignore sub-trees that contain invalid XMP data. It will only throw on serious errors.

Parameters:

input - the stream contains an XMP packet serialized as RDF/XML

parseContext - a map to provide options for the parser, or return additional information other than the XMP data model; can be null if not needed

Returns:

an XMPMetadata object created from the input

Throws:

XMPException - If the data is invalid XML, invalid XMP or contains invalid data

parse

XMPMetadata parse(java.lang.String input,
                  java.util.Map<java.lang.String,java.lang.Object> parseContext)
           throws XMPException

Parse XMP in RDF/XML form from a String The parser will simply ignore sub-trees that contain invalid XMP data. It will only throw on serious errors.

Parameters:

input - String that contains an XMP packet serialized as RDF/XML

parseContext - a map to provide options for the parser, or return additional information other than the XMP data model; can be null if not needed

Returns:

an XMPMetadata object

Throws:

XMPException

parse

XMPMetadata parse(byte[] input,
                  java.util.Map<java.lang.String,java.lang.Object> parseContext)
           throws XMPException

Parse XMP in RDF/XML form from a byte buffer. The data must be encoded with UTF-8. The parser will simply ignore sub-trees that contain invalid XMP data. It will only throw on serious errors.

Parameters:

input - buffer that contains an XMP packet serialized as RDF/XML

parseContext - a map to provide options for the parser, or return additional information other than the XMP data model; can be null if not needed

Returns:

an XMPMetadata object

Throws:

XMPException