org.apache.axiom.om.impl.builder

Class SAXOMBuilder

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.apache.axiom.om.impl.builder.SAXOMBuilder

All Implemented Interfaces:

OMXMLParserWrapper, org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler, org.xml.sax.ext.DeclHandler, org.xml.sax.ext.LexicalHandler

public class SAXOMBuilder
extends org.xml.sax.helpers.DefaultHandler
implements org.xml.sax.ext.LexicalHandler, org.xml.sax.ext.DeclHandler, OMXMLParserWrapper

Field Summary

Fields

Modifier and Type	Field and Description
private OMDocument	document
private java.lang.String	dtdName Stores the root name if there is a DTD.
private java.lang.String	dtdPublicId Stores the public ID if there is a DTD.
private java.lang.String	dtdSystemId Stores the system ID if there is a DTD.
private java.util.Map	entities Stores the replacement values for entities.
private int	entityReferenceDepth
private boolean	expandEntityReferences
private OMFactoryEx	factory
private boolean	inEntityReference
private boolean	inExternalSubset Flag indicating that the parser is processing the external subset.
private java.lang.StringBuilder	internalSubset Stores the internal subset if there is a DTD.
(package private) OMNode	lastNode
(package private) OMElement	nextElem
(package private) java.util.List	prefixMappings
(package private) OMElement	root
private javax.xml.transform.sax.SAXSource	source
(package private) int	textNodeType

Constructor Summary

Constructors

Constructor and Description
SAXOMBuilder() Deprecated. Instead of creating an instance of this class directly, create a SAXSource and use OMXMLBuilderFactory.createOMBuilder(SAXSource, boolean).
SAXOMBuilder(OMFactory factory) Deprecated. Instead of creating an instance of this class directly, create a SAXSource and use OMXMLBuilderFactory.createOMBuilder(OMFactory, SAXSource, boolean).
SAXOMBuilder(OMFactory factory, javax.xml.transform.sax.SAXSource source, boolean expandEntityReferences) For internal use only.

Method Summary

Modifier and Type	Method and Description
private void	addNode(OMNode node)
void	attributeDecl(java.lang.String eName, java.lang.String aName, java.lang.String type, java.lang.String mode, java.lang.String value)
void	characterData(char[] ch, int start, int length, int nodeType)
void	characters(char[] ch, int start, int length)
void	close() Close this builder.
void	comment(char[] ch, int start, int length)
protected OMElement	createNextElement(java.lang.String localName)
void	discard(OMElement el)
void	elementDecl(java.lang.String name, java.lang.String model)
void	endCDATA()
void	endDocument()
void	endDTD()
void	endElement(java.lang.String uri, java.lang.String localName, java.lang.String qName)
void	endEntity(java.lang.String name)
void	endPrefixMapping(java.lang.String prefix)
void	externalEntityDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId)
short	getBuilderType() Returns the type of the builder.
java.lang.String	getCharacterEncoding() Returns the encoding style of the XML data
private OMContainer	getContainer()
OMDocument	getDocument() Get the document being built by this builder.
OMElement	getDocumentElement() Get the document element, i.e.
OMElement	getDocumentElement(boolean discardDocument) Get the document element, optionally discarding the document.
java.lang.Object	getParser() Allows to access the underlying parser.
java.lang.Object	getRegisteredContentHandler() get the registered external content handler
OMElement	getRootElement() Get the root element of the Axiom tree built by this content handler.
void	ignorableWhitespace(char[] ch, int start, int length)
void	internalEntityDecl(java.lang.String name, java.lang.String value)
boolean	isCache()
boolean	isCompleted()
int	next() Proceed the parser one step and return the event value.
void	notationDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId)
void	processingInstruction(java.lang.String target, java.lang.String data)
void	registerExternalContentHandler(java.lang.Object obj) Registers an external content handler.
void	setCache(boolean b)
void	setDocumentLocator(org.xml.sax.Locator locator)
void	skippedEntity(java.lang.String name)
void	startCDATA()
void	startDocument()
void	startDTD(java.lang.String name, java.lang.String publicId, java.lang.String systemId)
void	startElement(java.lang.String namespaceURI, java.lang.String localName, java.lang.String qName, org.xml.sax.Attributes atts)
void	startEntity(java.lang.String name)
void	startPrefixMapping(java.lang.String prefix, java.lang.String uri)
void	unparsedEntityDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId, java.lang.String notationName)

Methods inherited from class org.xml.sax.helpers.DefaultHandler

error, fatalError, resolveEntity, warning

Methods inherited from class java.lang.Object

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

Field Detail

source

private final javax.xml.transform.sax.SAXSource source

expandEntityReferences

private final boolean expandEntityReferences

document

private OMDocument document

dtdName

private java.lang.String dtdName

Stores the root name if there is a DTD.

dtdPublicId

private java.lang.String dtdPublicId

Stores the public ID if there is a DTD.

dtdSystemId

private java.lang.String dtdSystemId

Stores the system ID if there is a DTD.

internalSubset

private java.lang.StringBuilder internalSubset

Stores the internal subset if there is a DTD.

entities

private java.util.Map entities

Stores the replacement values for entities.

inExternalSubset

private boolean inExternalSubset

Flag indicating that the parser is processing the external subset.

root

OMElement root

lastNode

OMNode lastNode

nextElem

OMElement nextElem

factory

private final OMFactoryEx factory

prefixMappings

java.util.List prefixMappings

textNodeType

int textNodeType

inEntityReference

private boolean inEntityReference

entityReferenceDepth

private int entityReferenceDepth

Constructor Detail

SAXOMBuilder

public SAXOMBuilder(OMFactory factory,
                    javax.xml.transform.sax.SAXSource source,
                    boolean expandEntityReferences)

For internal use only.

Parameters:

factory -

source -

expandEntityReferences -

SAXOMBuilder

public SAXOMBuilder(OMFactory factory)

Deprecated. Instead of creating an instance of this class directly, create a SAXSource and use OMXMLBuilderFactory.createOMBuilder(OMFactory, SAXSource, boolean).

SAXOMBuilder

public SAXOMBuilder()

Deprecated. Instead of creating an instance of this class directly, create a SAXSource and use OMXMLBuilderFactory.createOMBuilder(SAXSource, boolean).

Method Detail

getContainer

private OMContainer getContainer()

addNode

private void addNode(OMNode node)

setDocumentLocator

public void setDocumentLocator(org.xml.sax.Locator locator)

Specified by:

setDocumentLocator in interface org.xml.sax.ContentHandler

Overrides:

setDocumentLocator in class org.xml.sax.helpers.DefaultHandler

startDocument

public void startDocument()
                   throws org.xml.sax.SAXException

Specified by:

startDocument in interface org.xml.sax.ContentHandler

Overrides:

startDocument in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

endDocument

public void endDocument()
                 throws org.xml.sax.SAXException

Specified by:

endDocument in interface org.xml.sax.ContentHandler

Overrides:

endDocument in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

startDTD

public void startDTD(java.lang.String name,
                     java.lang.String publicId,
                     java.lang.String systemId)
              throws org.xml.sax.SAXException

Specified by:

startDTD in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException

elementDecl

public void elementDecl(java.lang.String name,
                        java.lang.String model)
                 throws org.xml.sax.SAXException

Specified by:

elementDecl in interface org.xml.sax.ext.DeclHandler

Throws:

org.xml.sax.SAXException

attributeDecl

public void attributeDecl(java.lang.String eName,
                          java.lang.String aName,
                          java.lang.String type,
                          java.lang.String mode,
                          java.lang.String value)
                   throws org.xml.sax.SAXException

Specified by:

attributeDecl in interface org.xml.sax.ext.DeclHandler

Throws:

org.xml.sax.SAXException

externalEntityDecl

public void externalEntityDecl(java.lang.String name,
                               java.lang.String publicId,
                               java.lang.String systemId)
                        throws org.xml.sax.SAXException

Specified by:

externalEntityDecl in interface org.xml.sax.ext.DeclHandler

Throws:

org.xml.sax.SAXException

internalEntityDecl

public void internalEntityDecl(java.lang.String name,
                               java.lang.String value)
                        throws org.xml.sax.SAXException

Specified by:

internalEntityDecl in interface org.xml.sax.ext.DeclHandler

Throws:

org.xml.sax.SAXException

notationDecl

public void notationDecl(java.lang.String name,
                         java.lang.String publicId,
                         java.lang.String systemId)
                  throws org.xml.sax.SAXException

Specified by:

notationDecl in interface org.xml.sax.DTDHandler

Overrides:

notationDecl in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

unparsedEntityDecl

public void unparsedEntityDecl(java.lang.String name,
                               java.lang.String publicId,
                               java.lang.String systemId,
                               java.lang.String notationName)
                        throws org.xml.sax.SAXException

Specified by:

unparsedEntityDecl in interface org.xml.sax.DTDHandler

Overrides:

unparsedEntityDecl in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

endDTD

public void endDTD()
            throws org.xml.sax.SAXException

Specified by:

endDTD in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException

createNextElement

protected OMElement createNextElement(java.lang.String localName)
                               throws OMException

Throws:

OMException

startPrefixMapping

public void startPrefixMapping(java.lang.String prefix,
                               java.lang.String uri)
                        throws org.xml.sax.SAXException

Specified by:

startPrefixMapping in interface org.xml.sax.ContentHandler

Overrides:

startPrefixMapping in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

endPrefixMapping

public void endPrefixMapping(java.lang.String prefix)
                      throws org.xml.sax.SAXException

Specified by:

endPrefixMapping in interface org.xml.sax.ContentHandler

Overrides:

endPrefixMapping in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

startElement

public void startElement(java.lang.String namespaceURI,
                         java.lang.String localName,
                         java.lang.String qName,
                         org.xml.sax.Attributes atts)
                  throws org.xml.sax.SAXException

Specified by:

startElement in interface org.xml.sax.ContentHandler

Overrides:

startElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

endElement

public void endElement(java.lang.String uri,
                       java.lang.String localName,
                       java.lang.String qName)
                throws org.xml.sax.SAXException

Specified by:

endElement in interface org.xml.sax.ContentHandler

Overrides:

endElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

startCDATA

public void startCDATA()
                throws org.xml.sax.SAXException

Specified by:

startCDATA in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException

endCDATA

public void endCDATA()
              throws org.xml.sax.SAXException

Specified by:

endCDATA in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException

characterData

public void characterData(char[] ch,
                          int start,
                          int length,
                          int nodeType)
                   throws org.xml.sax.SAXException

Throws:

org.xml.sax.SAXException

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws org.xml.sax.SAXException

Specified by:

characters in interface org.xml.sax.ContentHandler

Overrides:

characters in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws org.xml.sax.SAXException

Specified by:

ignorableWhitespace in interface org.xml.sax.ContentHandler

Overrides:

ignorableWhitespace in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

processingInstruction

public void processingInstruction(java.lang.String target,
                                  java.lang.String data)
                           throws org.xml.sax.SAXException

Specified by:

processingInstruction in interface org.xml.sax.ContentHandler

Overrides:

processingInstruction in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

comment

public void comment(char[] ch,
                    int start,
                    int length)
             throws org.xml.sax.SAXException

Specified by:

comment in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException

skippedEntity

public void skippedEntity(java.lang.String name)
                   throws org.xml.sax.SAXException

Specified by:

skippedEntity in interface org.xml.sax.ContentHandler

Overrides:

skippedEntity in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

startEntity

public void startEntity(java.lang.String name)
                 throws org.xml.sax.SAXException

Specified by:

startEntity in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException

endEntity

public void endEntity(java.lang.String name)
               throws org.xml.sax.SAXException

Specified by:

endEntity in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException

getDocument

public OMDocument getDocument()

Description copied from interface: OMXMLParserWrapper

Get the document being built by this builder.

Specified by:

getDocument in interface OMXMLParserWrapper

Returns:

the OMDocument instance

getRootElement

public OMElement getRootElement()

Get the root element of the Axiom tree built by this content handler.

Returns:

the root element of the tree

Throws:

OMException - if the tree is not complete

next

public int next()
         throws OMException

Description copied from interface: OMXMLParserWrapper

Proceed the parser one step and return the event value.

Specified by:

next in interface OMXMLParserWrapper

Returns:

Returns int.

Throws:

OMException

discard

public void discard(OMElement el)
             throws OMException

Specified by:

discard in interface OMXMLParserWrapper

Throws:

OMException

setCache

public void setCache(boolean b)
              throws OMException

Specified by:

setCache in interface OMXMLParserWrapper

Throws:

OMException

isCache

public boolean isCache()

Specified by:

isCache in interface OMXMLParserWrapper

Returns:

true if caching

getParser

public java.lang.Object getParser()

Description copied from interface: OMXMLParserWrapper

Allows to access the underlying parser. Since the parser depends on the underlying implementation, an Object is returned. However the implementations may have restrictions in letting access to the parser.

Specified by:

getParser in interface OMXMLParserWrapper

Returns:

Returns Object.

isCompleted

public boolean isCompleted()

Specified by:

isCompleted in interface OMXMLParserWrapper

Returns:

Returns the complete status.

getDocumentElement

public OMElement getDocumentElement()

Description copied from interface: OMXMLParserWrapper

Get the document element, i.e. the root element of the document. Using this method is equivalent to using OMDocument.getOMDocumentElement() on the document returned by OMXMLParserWrapper.getDocument().

Note that this method will never return null (except in the very special case where the document has been requested before and the document element has been removed explicitly): if the document being parsed has no document element, then this will result in a parser error, i.e. an OMException will be thrown.

Specified by:

getDocumentElement in interface OMXMLParserWrapper

Returns:

the document element

getDocumentElement

public OMElement getDocumentElement(boolean discardDocument)

Description copied from interface: OMXMLParserWrapper

Get the document element, optionally discarding the document. The return value of this method is the same as OMXMLParserWrapper.getDocumentElement(). However, if the discardDocument parameter is set to true, then the document element is removed from the document and the document itself is discarded. In contrast to using OMNode.detach() this will not build the element. The implementation also ensures that the element is not built when it is added to another OM tree. This makes it possible to add the content of a document to an existing OM tree while preserving the deferred parsing feature. It is even possible to create an OM tree where different subtrees are associated with different builder instances.

Specified by:

getDocumentElement in interface OMXMLParserWrapper

Parameters:

discardDocument - specifies whether the document should be discarded

Returns:

the document element

getBuilderType

public short getBuilderType()

Description copied from interface: OMXMLParserWrapper

Returns the type of the builder. Can be either OMConstants.PUSH_TYPE_BUILDER or OMConstants.PULL_TYPE_BUILDER.

Specified by:

getBuilderType in interface OMXMLParserWrapper

Returns:

Returns short.

registerExternalContentHandler

public void registerExternalContentHandler(java.lang.Object obj)

Description copied from interface: OMXMLParserWrapper

Registers an external content handler. Especially useful for push type builders. Throws an unsupportedOperationException if such handler registration is not supported.

Specified by:

registerExternalContentHandler in interface OMXMLParserWrapper

getRegisteredContentHandler

public java.lang.Object getRegisteredContentHandler()

Description copied from interface: OMXMLParserWrapper

get the registered external content handler

Specified by:

getRegisteredContentHandler in interface OMXMLParserWrapper

Returns:

Returns Object.

getCharacterEncoding

public java.lang.String getCharacterEncoding()

Description copied from interface: OMXMLParserWrapper

Returns the encoding style of the XML data

Specified by:

getCharacterEncoding in interface OMXMLParserWrapper

Returns:

the character encoding, defaults to "UTF-8"

close

public void close()

Description copied from interface: OMXMLParserWrapper

Close this builder. This method frees the resources associated with this builder. In particular, it releases the resources held by the underlying parser. This method does not close the underlying input source.

Specified by:

close in interface OMXMLParserWrapper