org.apache.axiom.om

Class OMXMLBuilderFactory

java.lang.Object

org.apache.axiom.om.OMXMLBuilderFactory

public class OMXMLBuilderFactory
extends java.lang.Object

Provides static factory methods to create various kinds of object model builders from different types of input sources. The methods defined by this class are the starting point to parse XML documents into Axiom trees.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	OMXMLBuilderFactory()

Method Summary

Modifier and Type	Method and Description
static OMXMLParserWrapper	createOMBuilder(java.io.InputStream in) Create an object model builder that reads a plain XML document from the provided input stream with the default parser configuration defined by StAXParserConfiguration.DEFAULT.
static OMXMLParserWrapper	createOMBuilder(java.io.InputStream in, java.lang.String encoding) Create an object model builder that reads a plain XML document from the provided input stream with the default parser configuration defined by StAXParserConfiguration.DEFAULT.
static OMXMLParserWrapper	createOMBuilder(org.w3c.dom.Node node, boolean expandEntityReferences) Create an object model builder that reads a plain XML document from the provided DOM tree.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, java.io.InputStream in) Create an object model builder that reads an XML document from the provided input stream using a specified object model factory and with the default parser configuration defined by StAXParserConfiguration.DEFAULT.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, java.io.InputStream in, java.lang.String encoding) Create an object model builder that reads an XML document from the provided input stream using a specified object model factory and with the default parser configuration defined by StAXParserConfiguration.DEFAULT.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, org.w3c.dom.Node node, boolean expandEntityReferences) Create an object model builder that reads an XML document from the provided DOM tree using a specified object model factory.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, java.io.Reader in) Create an object model builder that reads an XML document from the provided character stream using a specified object model factory and with the default parser configuration defined by StAXParserConfiguration.DEFAULT.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, javax.xml.transform.sax.SAXSource source, boolean expandEntityReferences) Create an object model builder that reads an XML document from the provided SAXSource using a specified object model factory.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, javax.xml.transform.Source source) Create an object model builder that reads an XML document from the provided Source using a specified object model factory.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, StAXParserConfiguration configuration, Attachments attachments) Create an XOP aware model builder from the provided Attachments object using a specified object model factory and with a given parser configuration.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, StAXParserConfiguration configuration, java.io.InputStream in) Create an object model builder that reads an XML document from the provided input stream using a specified object model factory and with a given parser configuration.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, StAXParserConfiguration configuration, java.io.InputStream in, java.lang.String encoding) Create an object model builder that reads an XML document from the provided input stream using a specified object model factory and with a given parser configuration.
static OMXMLParserWrapper	createOMBuilder(OMFactory omFactory, StAXParserConfiguration configuration, java.io.Reader in) Create an object model builder that reads an XML document from the provided character stream using a specified object model factory and with a given parser configuration.
static OMXMLParserWrapper	createOMBuilder(java.io.Reader in) Create an object model builder that reads a plain XML document from the provided character stream with the default parser configuration defined by StAXParserConfiguration.DEFAULT.
static OMXMLParserWrapper	createOMBuilder(javax.xml.transform.sax.SAXSource source, boolean expandEntityReferences) Create an object model builder that reads a plain XML document from the provided SAXSource.
static OMXMLParserWrapper	createOMBuilder(javax.xml.transform.Source source) Create an object model builder that reads a plain XML document from the provided Source.
static OMXMLParserWrapper	createOMBuilder(StAXParserConfiguration configuration, Attachments attachments) Create an XOP aware model builder from the provided Attachments object and with a given parser configuration.
static OMXMLParserWrapper	createOMBuilder(StAXParserConfiguration configuration, java.io.InputStream in) Create an object model builder that reads a plain XML document from the provided input stream with a given parser configuration.
static OMXMLParserWrapper	createOMBuilder(StAXParserConfiguration configuration, java.io.InputStream in, java.lang.String encoding) Create an object model builder that reads a plain XML document from the provided input stream with a given parser configuration.
static OMXMLParserWrapper	createOMBuilder(StAXParserConfiguration configuration, java.io.Reader in) Create an object model builder that reads a plain XML document from the provided character stream with a given parser configuration.
static SOAPModelBuilder	createSOAPModelBuilder(Attachments attachments) Create an MTOM aware model builder from the provided Attachments object.
static SOAPModelBuilder	createSOAPModelBuilder(java.io.InputStream in, java.lang.String encoding) Create an object model builder for SOAP that reads a message from the provided input stream, using a given charset encoding.
static SOAPModelBuilder	createSOAPModelBuilder(OMMetaFactory metaFactory, Attachments attachments) Create an MTOM aware model builder from the provided Attachments object using a particular Axiom implementation.
static SOAPModelBuilder	createSOAPModelBuilder(OMMetaFactory metaFactory, java.io.InputStream in, java.lang.String encoding) Create an object model builder for SOAP that reads a message from the provided input stream, using a particular Axiom implementation and a given charset encoding.
static SOAPModelBuilder	createSOAPModelBuilder(OMMetaFactory metaFactory, java.io.Reader in) Create an object model builder for SOAP that reads a message from the provided character stream using a particular Axiom implementation.
static SOAPModelBuilder	createSOAPModelBuilder(java.io.Reader in) Create an object model builder for SOAP that reads a message from the provided character stream.
static OMXMLParserWrapper	createStAXOMBuilder(OMFactory omFactory, javax.xml.stream.XMLStreamReader parser) Create an object model builder that pulls events from a StAX stream reader using a specified object model factory.
static OMXMLParserWrapper	createStAXOMBuilder(javax.xml.stream.XMLStreamReader parser) Create an object model builder for plain XML that pulls events from a StAX stream reader.
static SOAPModelBuilder	createStAXSOAPModelBuilder(OMMetaFactory metaFactory, javax.xml.stream.XMLStreamReader parser) Create an object model builder for SOAP that pulls events from a StAX stream reader and that uses a particular Axiom implementation.
static SOAPModelBuilder	createStAXSOAPModelBuilder(javax.xml.stream.XMLStreamReader parser) Create an object model builder for SOAP that pulls events from a StAX stream reader.
private static org.xml.sax.InputSource	getRootPartInputSource(Attachments attachments, javax.mail.internet.ContentType contentType)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OMXMLBuilderFactory

private OMXMLBuilderFactory()

Method Detail

createStAXOMBuilder

public static OMXMLParserWrapper createStAXOMBuilder(javax.xml.stream.XMLStreamReader parser)

Create an object model builder for plain XML that pulls events from a StAX stream reader.

The reader must be positioned on a XMLStreamConstants.START_DOCUMENT or XMLStreamConstants.START_ELEMENT event. If the current event is XMLStreamConstants.START_DOCUMENT then the builder will consume events up to the XMLStreamConstants.END_DOCUMENT event. If the current event is XMLStreamConstants.START_ELEMENT, then the builder will consume events up to the corresponding XMLStreamConstants.END_ELEMENT. After the object model is completely built, the stream reader will be positioned on the event immediately following this XMLStreamConstants.END_ELEMENT event. This means that this method can be used in a well defined way to build an object model from a fragment (corresponding to a single element) of the document represented by the stream reader.

The returned builder also performs namespace repairing, i.e. it adds appropriate namespace declarations if undeclared namespaces appear in the StAX stream.

Parameters:

parser - the stream reader to read the XML data from

Returns:

the builder

Throws:

OMException - if the stream reader is positioned on an event other than XMLStreamConstants.START_DOCUMENT or XMLStreamConstants.START_ELEMENT

createStAXOMBuilder

public static OMXMLParserWrapper createStAXOMBuilder(OMFactory omFactory,
                                                     javax.xml.stream.XMLStreamReader parser)

Create an object model builder that pulls events from a StAX stream reader using a specified object model factory.

See createStAXOMBuilder(XMLStreamReader) for more information about the behavior of the returned builder.

Parameters:

omFactory - the object model factory to use

parser - the stream reader to read the XML data from

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(java.io.InputStream in)

Create an object model builder that reads a plain XML document from the provided input stream with the default parser configuration defined by StAXParserConfiguration.DEFAULT.

Parameters:

in - the input stream representing the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(java.io.InputStream in,
                                                 java.lang.String encoding)

Create an object model builder that reads a plain XML document from the provided input stream with the default parser configuration defined by StAXParserConfiguration.DEFAULT.

Parameters:

in - the input stream representing the XML document

encoding - the charset encoding of the XML document or null if the parser should determine the charset encoding

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(StAXParserConfiguration configuration,
                                                 java.io.InputStream in)

Create an object model builder that reads a plain XML document from the provided input stream with a given parser configuration.

Parameters:

configuration - the parser configuration to use

in - the input stream representing the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(StAXParserConfiguration configuration,
                                                 java.io.InputStream in,
                                                 java.lang.String encoding)

Create an object model builder that reads a plain XML document from the provided input stream with a given parser configuration.

Parameters:

configuration - the parser configuration to use

in - the input stream representing the XML document

encoding - the charset encoding of the XML document or null if the parser should determine the charset encoding

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 java.io.InputStream in)

Create an object model builder that reads an XML document from the provided input stream using a specified object model factory and with the default parser configuration defined by StAXParserConfiguration.DEFAULT.

Parameters:

omFactory - the object model factory to use

in - the input stream representing the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 java.io.InputStream in,
                                                 java.lang.String encoding)

Create an object model builder that reads an XML document from the provided input stream using a specified object model factory and with the default parser configuration defined by StAXParserConfiguration.DEFAULT.

Parameters:

omFactory - the object model factory to use

in - the input stream representing the XML document

encoding - the charset encoding of the XML document or null if the parser should determine the charset encoding

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 StAXParserConfiguration configuration,
                                                 java.io.InputStream in)

Create an object model builder that reads an XML document from the provided input stream using a specified object model factory and with a given parser configuration.

Parameters:

omFactory - the object model factory to use

configuration - the parser configuration to use

in - the input stream representing the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 StAXParserConfiguration configuration,
                                                 java.io.InputStream in,
                                                 java.lang.String encoding)

Create an object model builder that reads an XML document from the provided input stream using a specified object model factory and with a given parser configuration.

Parameters:

omFactory - the object model factory to use

configuration - the parser configuration to use

in - the input stream representing the XML document

encoding - the charset encoding of the XML document or null if the parser should determine the charset encoding

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(java.io.Reader in)

Create an object model builder that reads a plain XML document from the provided character stream with the default parser configuration defined by StAXParserConfiguration.DEFAULT.

Parameters:

in - the character stream representing the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(StAXParserConfiguration configuration,
                                                 java.io.Reader in)

Create an object model builder that reads a plain XML document from the provided character stream with a given parser configuration.

Parameters:

configuration - the parser configuration to use

in - the character stream representing the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 java.io.Reader in)

Create an object model builder that reads an XML document from the provided character stream using a specified object model factory and with the default parser configuration defined by StAXParserConfiguration.DEFAULT.

Parameters:

omFactory - the object model factory to use

in - the character stream representing the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 StAXParserConfiguration configuration,
                                                 java.io.Reader in)

Create an object model builder that reads an XML document from the provided character stream using a specified object model factory and with a given parser configuration.

Parameters:

omFactory - the object model factory to use

configuration - the parser configuration to use

in - the character stream representing the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(javax.xml.transform.Source source)

Create an object model builder that reads a plain XML document from the provided Source.

Parameters:

source - the source of the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(org.w3c.dom.Node node,
                                                 boolean expandEntityReferences)

Create an object model builder that reads a plain XML document from the provided DOM tree.

Parameters:

node - the DOM node; must be a Node.DOCUMENT_NODE or Node.ELEMENT_NODE

expandEntityReferences - Determines how EntityReference nodes are handled:

• If the parameter is false then a single OMEntityReference will be created for each EntityReference. The child nodes of EntityReference nodes are not taken into account.
• If the parameter is true then no OMEntityReference nodes are created and the children of EntityReference nodes are converted and inserted into the Axiom tree.

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(javax.xml.transform.sax.SAXSource source,
                                                 boolean expandEntityReferences)

Create an object model builder that reads a plain XML document from the provided SAXSource.

Parameters:

source - the source of the XML document

expandEntityReferences - Determines how entity references (i.e. LexicalHandler.startEntity(String) and LexicalHandler.endEntity(String) events) are handled:

• If the parameter is false then a single OMEntityReference will be created for each pair of LexicalHandler.startEntity(String) and LexicalHandler.endEntity(String) events. Other events reported between these two events are not taken into account.
• If the parameter is true then no OMEntityReference nodes are created and LexicalHandler.startEntity(String) and LexicalHandler.endEntity(String) events are ignored. However, events between LexicalHandler.startEntity(String) and LexicalHandler.endEntity(String) are processed normally.

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 javax.xml.transform.Source source)

Create an object model builder that reads an XML document from the provided Source using a specified object model factory.

Parameters:

omFactory - the object model factory to use

source - the source of the XML document

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 org.w3c.dom.Node node,
                                                 boolean expandEntityReferences)

Create an object model builder that reads an XML document from the provided DOM tree using a specified object model factory.

Parameters:

omFactory - the object model factory to use

node - the DOM node; must be a Node.DOCUMENT_NODE or Node.ELEMENT_NODE

expandEntityReferences - Determines how EntityReference nodes are handled:

• If the parameter is false then a single OMEntityReference will be created for each EntityReference. The child nodes of EntityReference nodes are not taken into account.
• If the parameter is true then no OMEntityReference nodes are created and the children of EntityReference nodes are converted and inserted into the Axiom tree.

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 javax.xml.transform.sax.SAXSource source,
                                                 boolean expandEntityReferences)

Create an object model builder that reads an XML document from the provided SAXSource using a specified object model factory.

Parameters:

omFactory - the object model factory to use

source - the source of the XML document

expandEntityReferences - Determines how entity references (i.e. LexicalHandler.startEntity(String) and LexicalHandler.endEntity(String) events) are handled:

• If the parameter is false then a single OMEntityReference will be created for each pair of LexicalHandler.startEntity(String) and LexicalHandler.endEntity(String) events. Other events reported between these two events are not taken into account.
• If the parameter is true then no OMEntityReference nodes are created and LexicalHandler.startEntity(String) and LexicalHandler.endEntity(String) events are ignored. However, events between LexicalHandler.startEntity(String) and LexicalHandler.endEntity(String) are processed normally.

Returns:

the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(StAXParserConfiguration configuration,
                                                 Attachments attachments)

Create an XOP aware model builder from the provided Attachments object and with a given parser configuration.

Parameters:

configuration - the parser configuration to use

attachments - an Attachments object that must have been created from an input stream

Returns:

the builder

Throws:

OMException - if an error occurs while processing the content type information from the Attachments object

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 StAXParserConfiguration configuration,
                                                 Attachments attachments)

Create an XOP aware model builder from the provided Attachments object using a specified object model factory and with a given parser configuration.

Parameters:

omFactory - the object model factory to use

configuration - the parser configuration to use

attachments - an Attachments object that must have been created from an input stream

Returns:

the builder

Throws:

OMException - if an error occurs while processing the content type information from the Attachments object

createStAXSOAPModelBuilder

public static SOAPModelBuilder createStAXSOAPModelBuilder(OMMetaFactory metaFactory,
                                                          javax.xml.stream.XMLStreamReader parser)

Create an object model builder for SOAP that pulls events from a StAX stream reader and that uses a particular Axiom implementation. The method will select the appropriate SOAPFactory based on the namespace URI of the SOAP envelope.

See createStAXOMBuilder(XMLStreamReader) for more information about the behavior of the returned builder.

Parameters:

metaFactory - the meta factory for the Axiom implementation to use

parser - the stream reader to read the XML data from

Returns:

the builder

createStAXSOAPModelBuilder

public static SOAPModelBuilder createStAXSOAPModelBuilder(javax.xml.stream.XMLStreamReader parser)

Create an object model builder for SOAP that pulls events from a StAX stream reader. The method will select the appropriate SOAPFactory based on the namespace URI of the SOAP envelope.

See createStAXOMBuilder(XMLStreamReader) for more information about the behavior of the returned builder.

Parameters:

parser - the stream reader to read the XML data from

Returns:

the builder

createSOAPModelBuilder

public static SOAPModelBuilder createSOAPModelBuilder(java.io.InputStream in,
                                                      java.lang.String encoding)

Create an object model builder for SOAP that reads a message from the provided input stream, using a given charset encoding. The method will select the appropriate SOAPFactory based on the namespace URI of the SOAP envelope. It will configure the underlying parser as specified by StAXParserConfiguration.SOAP.

Parameters:

in - the input stream containing the SOAP message

encoding - the charset encoding of the SOAP message or null if the parser should determine the charset encoding

Returns:

the builder

createSOAPModelBuilder

public static SOAPModelBuilder createSOAPModelBuilder(OMMetaFactory metaFactory,
                                                      java.io.InputStream in,
                                                      java.lang.String encoding)

Create an object model builder for SOAP that reads a message from the provided input stream, using a particular Axiom implementation and a given charset encoding. The method will select the appropriate SOAPFactory based on the namespace URI of the SOAP envelope. It will configure the underlying parser as specified by StAXParserConfiguration.SOAP.

Parameters:

metaFactory - the meta factory for the Axiom implementation to use

in - the input stream containing the SOAP message

encoding - the charset encoding of the SOAP message or null if the parser should determine the charset encoding

Returns:

the builder

createSOAPModelBuilder

public static SOAPModelBuilder createSOAPModelBuilder(java.io.Reader in)

Create an object model builder for SOAP that reads a message from the provided character stream. The method will select the appropriate SOAPFactory based on the namespace URI of the SOAP envelope. It will configure the underlying parser as specified by StAXParserConfiguration.SOAP.

Parameters:

in - the character stream containing the SOAP message

Returns:

the builder

createSOAPModelBuilder

public static SOAPModelBuilder createSOAPModelBuilder(OMMetaFactory metaFactory,
                                                      java.io.Reader in)

Create an object model builder for SOAP that reads a message from the provided character stream using a particular Axiom implementation. The method will select the appropriate SOAPFactory based on the namespace URI of the SOAP envelope. It will configure the underlying parser as specified by StAXParserConfiguration.SOAP.

Parameters:

metaFactory - the meta factory for the Axiom implementation to use

in - the character stream containing the SOAP message

Returns:

the builder

createSOAPModelBuilder

public static SOAPModelBuilder createSOAPModelBuilder(Attachments attachments)

Create an MTOM aware model builder from the provided Attachments object. The method will determine the SOAP version based on the content type information from the Attachments object. It will configure the underlying parser as specified by StAXParserConfiguration.SOAP.

Parameters:

attachments - an Attachments object that must have been created from an input stream

Returns:

the builder

Throws:

OMException - if an error occurs while processing the content type information from the Attachments object

createSOAPModelBuilder

public static SOAPModelBuilder createSOAPModelBuilder(OMMetaFactory metaFactory,
                                                      Attachments attachments)

Create an MTOM aware model builder from the provided Attachments object using a particular Axiom implementation. The method will determine the SOAP version based on the content type information from the Attachments object. It will configure the underlying parser as specified by StAXParserConfiguration.SOAP.

Parameters:

metaFactory - the meta factory for the Axiom implementation to use

attachments - an Attachments object that must have been created from an input stream

Returns:

the builder

Throws:

OMException - if an error occurs while processing the content type information from the Attachments object

getRootPartInputSource

private static org.xml.sax.InputSource getRootPartInputSource(Attachments attachments,
                                                              javax.mail.internet.ContentType contentType)