public class StAXOMBuilder extends StAXBuilder
_isClosed, cache, charEncoding, customBuilderForPayload, customBuilders, dataHandlerReader, document, done, elementLevel, maxDepthForCustomBuilders, omfactory, parser, parserAccessed, parserException, target
Constructor and Description |
---|
StAXOMBuilder()
Deprecated.
|
StAXOMBuilder(InputStream inStream)
Deprecated.
Please use the
OMXMLBuilderFactory API. |
StAXOMBuilder(OMFactory ombuilderFactory,
javax.xml.stream.XMLStreamReader parser)
Deprecated.
Please use the
OMXMLBuilderFactory API. |
StAXOMBuilder(OMFactory ombuilderFactory,
javax.xml.stream.XMLStreamReader parser,
Detachable detachable,
Closeable closeable)
For internal use only.
|
StAXOMBuilder(OMFactory factory,
javax.xml.stream.XMLStreamReader parser,
OMElement element)
Deprecated.
Please use the
OMXMLBuilderFactory API. |
StAXOMBuilder(OMFactory factory,
javax.xml.stream.XMLStreamReader parser,
OMElement element,
String characterEncoding)
For internal use only.
|
StAXOMBuilder(String filePath)
Deprecated.
Please use the
OMXMLBuilderFactory API. |
StAXOMBuilder(javax.xml.stream.XMLStreamReader parser)
Deprecated.
Please use the
OMXMLBuilderFactory API. |
Modifier and Type | Method and Description |
---|---|
protected OMElement |
constructNode(OMContainer parent,
String elementName)
Instantiate the appropriate
OMElement implementation for the current element. |
protected OMNode |
createComment()
Method createOMText.
|
protected OMDocument |
createDocument() |
protected OMNode |
createDTD()
Method createDTD.
|
protected OMNode |
createEntityReference() |
protected OMNode |
createNextOMElement()
Creates a new OMElement using either a CustomBuilder or
the default Builder mechanism.
|
protected OMNode |
createOMElement()
Method createOMElement.
|
protected OMNode |
createPI()
Method createPI.
|
protected String |
createPrefix()
Deprecated.
A builder doesn't need to generate prefixes.
|
protected OMNode |
createWithCustomBuilder(CustomBuilder customBuilder,
OMFactory factory) |
OMElement |
getDocumentElement()
Get the document element, i.e. the root element of the document.
|
OMElement |
getDocumentElement(boolean discardDocument)
Get the document element, optionally discarding the document.
|
boolean |
isLookahead()
Check if the node for the current token has already been created or if the parser is ahead
of the builder.
|
boolean |
isNamespaceURIInterning() |
protected void |
logParserState()
Dump the current event of the parser.
|
boolean |
lookahead()
This method looks ahead to the next start element.
|
int |
next()
Method next.
|
protected void |
processNamespaceData(OMElement node)
Method processNamespaceData.
|
void |
setDoDebug(boolean doDebug)
Deprecated.
|
void |
setNamespaceURIInterning(boolean b)
Set namespace uri interning
|
close, createDocumentIfNecessary, createOMText, debugDiscarded, detach, disableCaching, discard, discard, getAttributeCount, getAttributeName, getAttributeNamespace, getAttributePrefix, getBuilderType, getCharacterEncoding, getCharsetEncoding, getCustomBuilder, getDocument, getName, getNamespace, getNamespaceCount, getNamespacePrefix, getNamespaceUri, getParser, getPrefix, getReaderProperty, getRegisteredContentHandler, getText, init, isCache, isClosed, isCompleted, processAttributes, reenableCaching, registerCustomBuilder, registerCustomBuilderForPayload, registerExternalContentHandler, releaseParserOnClose, setAutoClose, setCache, setOMBuilderFactory
public StAXOMBuilder(OMFactory ombuilderFactory, javax.xml.stream.XMLStreamReader parser, Detachable detachable, Closeable closeable)
public StAXOMBuilder(OMFactory ombuilderFactory, javax.xml.stream.XMLStreamReader parser)
OMXMLBuilderFactory
API.public StAXOMBuilder(OMFactory factory, javax.xml.stream.XMLStreamReader parser, OMElement element, String characterEncoding)
public StAXOMBuilder(OMFactory factory, javax.xml.stream.XMLStreamReader parser, OMElement element)
OMXMLBuilderFactory
API.public StAXOMBuilder(String filePath) throws javax.xml.stream.XMLStreamException, FileNotFoundException
OMXMLBuilderFactory
API.public StAXOMBuilder(javax.xml.stream.XMLStreamReader parser)
OMXMLBuilderFactory
API.public StAXOMBuilder(InputStream inStream) throws javax.xml.stream.XMLStreamException
OMXMLBuilderFactory
API.public StAXOMBuilder()
protected OMDocument createDocument()
createDocument
in class StAXBuilder
public int next() throws OMException
next
in interface OMXMLParserWrapper
next
in class StAXBuilder
OMException
protected OMNode createNextOMElement()
protected OMNode createWithCustomBuilder(CustomBuilder customBuilder, OMFactory factory)
protected void logParserState()
protected final OMNode createOMElement() throws OMException
createOMElement
in class StAXBuilder
OMException
protected OMElement constructNode(OMContainer parent, String elementName)
OMElement
implementation for the current element. This
method may be overridden by subclasses to support model specific OMElement
types. The
implementation of this method is expected to initialize the OMElement
with the
specified local name and to add it to the specified parent. However, the implementation
should not set the namespace of the element or process the attributes of the element. This is
taken care of by the caller of this method.parent
- the parent for the elementelementName
- the local name for the elementOMElement
; must not be null
protected OMNode createComment() throws OMException
OMException
protected OMNode createDTD() throws OMException
OMException
protected OMNode createPI() throws OMException
OMException
protected OMNode createEntityReference()
public OMElement getDocumentElement()
OMXMLParserWrapper
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.
public OMElement getDocumentElement(boolean discardDocument)
OMXMLParserWrapper
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.discardDocument
- specifies whether the document should be discardedprotected void processNamespaceData(OMElement node)
processNamespaceData
in class StAXBuilder
node
- public void setDoDebug(boolean doDebug)
doDebug
- protected String createPrefix()
public void setNamespaceURIInterning(boolean b)
b
- public boolean isNamespaceURIInterning()
public boolean lookahead()
public boolean isLookahead()
true
indicates that the parser is one token ahead
of the builder, i.e. that the node for the current token has not been created yet.
This state can only be reached by a call to lookahead()
, and the
current token is always a START_ELEMENT
.
The information related to that element can be obtained by calls to
StAXBuilder.getName()
, StAXBuilder.getNamespace()
, StAXBuilder.getPrefix()
,
StAXBuilder.getAttributeCount()
, StAXBuilder.getAttributeName(int)
,
StAXBuilder.getAttributeNamespace(int)
, StAXBuilder.getAttributePrefix(int)
,
StAXBuilder.getNamespaceCount()
, StAXBuilder.getNamespacePrefix(int)
and
StAXBuilder.getNamespaceUri(int)
.
A return value of false
indicates that the node corresponding to the
current token hold by the parser has already been created.
Copyright © The Apache Software Foundation. All Rights Reserved.