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, setOMBuilderFactorypublic 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 StAXBuilderpublic int next()
throws OMException
next in interface OMXMLParserWrappernext in class StAXBuilderOMExceptionprotected OMNode createNextOMElement()
protected OMNode createWithCustomBuilder(CustomBuilder customBuilder, OMFactory factory)
protected void logParserState()
protected final OMNode createOMElement() throws OMException
createOMElement in class StAXBuilderOMExceptionprotected 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 nullprotected OMNode createComment() throws OMException
OMExceptionprotected OMNode createDTD() throws OMException
OMExceptionprotected OMNode createPI() throws OMException
OMExceptionprotected OMNode createEntityReference()
public OMElement getDocumentElement()
OMXMLParserWrapperOMDocument.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)
OMXMLParserWrapperOMXMLParserWrapper.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 StAXBuildernode - 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.