org.pentaho.reporting.libraries.xmlns.parser

Interface XmlFactoryModule

public interface XmlFactoryModule

The XmlFactoryModule is the base of a plugin-structure to allow parser-multiplexing. In that case, the actual implementation of the parser will be selected according to the DTD, Namespace or root-tag of the document.

Author: Thomas Morgner

Field Summary
static intNOT_RECOGNIZED
A constant declaring that the content has NOT been recognized by any mean.
static intRECOGNIZED_BY_DTD
A constant declaring that the content has been recognized by the declared Document Type Declaration (DTD).
static intRECOGNIZED_BY_NAMESPACE
A constant declaring that the content has been recognized by the declared namespace.
static intRECOGNIZED_BY_TAGNAME
A constant declaring that the content has been recognized by the tagname of the root-element of the XML-document.
Method Summary
XmlReadHandlercreateReadHandler(XmlDocumentInfo documentInfo)
Creates an XmlReadHandler for the root-tag based on the given document information.
StringgetDefaultNamespace(XmlDocumentInfo documentInfo)
Returns the default namespace for a document with the characteristics given in the XmlDocumentInfo.
intgetDocumentSupport(XmlDocumentInfo documentInfo)
Checks the given document data to compute the propability of whether this factory module would be able to handle the given data.

Field Detail

NOT_RECOGNIZED

public static final int NOT_RECOGNIZED
A constant declaring that the content has NOT been recognized by any mean.

RECOGNIZED_BY_DTD

public static final int RECOGNIZED_BY_DTD
A constant declaring that the content has been recognized by the declared Document Type Declaration (DTD).

RECOGNIZED_BY_NAMESPACE

public static final int RECOGNIZED_BY_NAMESPACE
A constant declaring that the content has been recognized by the declared namespace.

RECOGNIZED_BY_TAGNAME

public static final int RECOGNIZED_BY_TAGNAME
A constant declaring that the content has been recognized by the tagname of the root-element of the XML-document.

Method Detail

createReadHandler

public XmlReadHandler createReadHandler(XmlDocumentInfo documentInfo)
Creates an XmlReadHandler for the root-tag based on the given document information.

Parameters: documentInfo the document information that has been extracted from the parser.

Returns: the root handler or null.

getDefaultNamespace

public String getDefaultNamespace(XmlDocumentInfo documentInfo)
Returns the default namespace for a document with the characteristics given in the XmlDocumentInfo.

Parameters: documentInfo the document information.

Returns: the default namespace uri for the document.

getDocumentSupport

public int getDocumentSupport(XmlDocumentInfo documentInfo)
Checks the given document data to compute the propability of whether this factory module would be able to handle the given data.

Parameters: documentInfo the document information collection.

Returns: an integer value indicating how good the document matches the factories requirements.