org.apache.axiom.om
Class OMXMLBuilderFactory

java.lang.Object
  extended by org.apache.axiom.om.OMXMLBuilderFactory

public class OMXMLBuilderFactory
extends 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.


Method Summary
static OMXMLParserWrapper createOMBuilder(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(InputStream in, 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(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, 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, InputStream in, 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, 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, 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, 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, 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, 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, InputStream in, 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, 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(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(SAXSource source, boolean expandEntityReferences)
          Create an object model builder that reads a plain XML document from the provided SAXSource.
static OMXMLParserWrapper createOMBuilder(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, 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, InputStream in, 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, 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(InputStream in, 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, InputStream in, 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, 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(Reader in)
          Create an object model builder for SOAP that reads a message from the provided character stream.
static OMXMLParserWrapper createStAXOMBuilder(OMFactory omFactory, XMLStreamReader parser)
          Create an object model builder that pulls events from a StAX stream reader using a specified object model factory.
static OMXMLParserWrapper createStAXOMBuilder(XMLStreamReader parser)
          Create an object model builder for plain XML that pulls events from a StAX stream reader.
static SOAPModelBuilder createStAXSOAPModelBuilder(OMMetaFactory metaFactory, 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(XMLStreamReader parser)
          Create an object model builder for SOAP that pulls events from a StAX stream reader.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

createStAXOMBuilder

public static OMXMLParserWrapper createStAXOMBuilder(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,
                                                     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(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(InputStream in,
                                                 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,
                                                 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,
                                                 InputStream in,
                                                 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,
                                                 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,
                                                 InputStream in,
                                                 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,
                                                 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,
                                                 InputStream in,
                                                 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(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,
                                                 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,
                                                 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,
                                                 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(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(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:
Returns:
the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(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:
Returns:
the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 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,
                                                 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:
Returns:
the builder

createOMBuilder

public static OMXMLParserWrapper createOMBuilder(OMFactory omFactory,
                                                 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:
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,
                                                          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(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(InputStream in,
                                                      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,
                                                      InputStream in,
                                                      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(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,
                                                      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


Copyright © 2004-2012 The Apache Software Foundation. All Rights Reserved.