XMLStreamWriter implementation that writes XML data to a new JDOM
Document. The document can be retrieved using getDocument().
This class is the inverse of the class StAXStreamBuilder in the sense that
this class is written to (it's an XMLStreamWriter implementation) to create a JDOM
Document whereas the StAXStreamBuilder reads from a user-supplied
XMLStreamReader. It is the difference between a 'push' concept and a 'pull' concept.
An interesting read for people using this class: Apache Axiom notes on setPrefix().
| Modifier and Type | Field and Description |
|---|---|
| private Element | |
| private Text | |
| private NamespaceStack | |
| private static final DefaultJDOMFactory | |
| private Document | |
| private boolean | |
| private final JDOMFactory | |
| private int | |
| private NamespaceContext | |
| private boolean | |
| private Parent | |
| private LinkedList | |
| private final boolean | |
| private NamespaceStack |
| Access | Constructor and Description |
|---|---|
| public | |
| public | StAXStreamWriter(final JDOMFactory
The JDOMFactory to use. fac, final boolean If true, then repair namespace errors. repairnamespace)Create a StAXStreamWriter with the specified JDOMFactory for creating JDOM Content. |
| Modifier and Type | Method and Description |
|---|---|
| private final void | buildAttribute(final String prefix, final String namespaceURI, final String localName, final String value, final boolean withpfx)
|
| private final void | buildElement(final String
The namespace prefix (may be null). prefix, final String The Element tag localName, final String The namespace URI (may be null). namespaceURI, final boolean whether the prefix is user-specified withpfx, boolean Is this an Empty element (expecting children?) empty)Simple method that implements the empty-element logic without the spec-required null-check logic |
| public void | close()
Implements javax. |
| public void | flush()
Implements javax. |
| private final void | |
| private final void | |
| private String | |
| public Document | |
| public NamespaceContext | getNamespaceContext()
Implements javax. |
| public String | getPrefix(final String
the uri the prefix is bound to uri)Implements javax. |
| public Object | getProperty(String
The name of the property, may not be null name)Implements javax. |
| private Namespace | |
| private Namespace | |
| public void | setDefaultNamespace(final String
the uri to bind to the default namespace, may be null uri)Implements javax. |
| public void | setNamespaceContext(final NamespaceContext
the namespace context to use for this writer, may not be null context)Implements javax. |
| public void | setPrefix(final String
the prefix to bind to the uri, may not be null prefix, final String the uri to bind to the prefix, may be null uri)Implements javax. |
| public void | writeAttribute(final String
the local name of the attribute localName, final String the value of the attribute value)Implements javax. |
| public void | writeAttribute(final String
the uri of the prefix for this attribute namespaceURI, final String the local name of the attribute localName, final String the value of the attribute value)Implements javax. |
| public void | writeAttribute(final String
the prefix for this attribute prefix, final String the uri of the prefix for this attribute namespaceURI, final String the local name of the attribute localName, final String the value of the attribute value)Implements javax. |
| public void | writeCData(final String
the data contained in the CData Section, may not be null data)Implements javax. |
| public void | writeCharacters(final String
the value to write chars)Implements javax. |
| public void | writeCharacters(final char[]
the value to write chars, final int the starting position in the array start, final int the number of characters to write len)Implements javax. |
| public void | writeComment(final String
the data contained in the comment, may be null data)Implements javax. |
| public void | writeDefaultNamespace(final String
the uri to bind the default namespace to namespaceURI)Implements javax. |
| public void | writeDTD(final String
the DTD to be written dtd)Implements javax. |
| public void | writeEmptyElement(final String
local name of the tag, may not be null localName)Implements javax. |
| public void | writeEmptyElement(final String
the uri to bind the tag to, may not be null namespaceURI, final String local name of the tag, may not be null localName)Implements javax. |
| public void | writeEmptyElement(final String
the prefix of the tag, may not be null prefix, final String local name of the tag, may not be null localName, final String the uri to bind the tag to, may not be null namespaceURI)Implements javax. |
| public void | writeEndDocument()
Implements javax. |
| public void | writeEndElement()
Implements javax. |
| public void | writeEntityRef(final String
the name of the entity name)Implements javax. |
| public void | writeNamespace(final String
the prefix to bind this namespace to prefix, final String the uri to bind the prefix to namespaceURI)Implements javax. |
| public void | writeProcessingInstruction(final String
the target of the processing instruction, may not be null target)Implements javax. |
| public void | writeProcessingInstruction(final String
the target of the processing instruction, may not be null target, final String the data contained in the processing instruction, may not be null data)Implements javax. |
| public void | writeStartDocument()
Implements javax. |
| public void | writeStartDocument(final String
version of the xml document version)Implements javax. |
| public void | writeStartDocument(final String
encoding of the xml declaration encoding, final String version of the xml document version)Implements javax. |
| public void | writeStartElement(final String
local name of the tag, may not be null localName)Implements javax. |
| public void | writeStartElement(final String
the namespaceURI of the prefix to use, may not be null namespaceURI, final String local name of the tag, may not be null localName)Implements javax. |
| public void | writeStartElement(final String
the prefix of the tag, may not be null prefix, final String local name of the tag, may not be null localName, final String the uri to bind the prefix to, may not be null namespaceURI)Implements javax. |
| activeelement | back to summary |
|---|---|
| private Element activeelement | |
| activetext | back to summary |
|---|---|
| private Text activetext | |
| boundstack | back to summary |
|---|---|
| private NamespaceStack boundstack | |
| DEFFAC | back to summary |
|---|---|
| private static final DefaultJDOMFactory DEFFAC | |
| document | back to summary |
|---|---|
| private Document document | |
| done | back to summary |
|---|---|
| private boolean done | |
| factory | back to summary |
|---|---|
| private final JDOMFactory factory | |
| genprefix | back to summary |
|---|---|
| private int genprefix | |
| globalcontext | back to summary |
|---|---|
| private NamespaceContext globalcontext | |
| isempty | back to summary |
|---|---|
| private boolean isempty | |
| parent | back to summary |
|---|---|
| private Parent parent | |
| pendingns | back to summary |
|---|---|
| private LinkedList<Namespace> pendingns | |
| repairnamespace | back to summary |
|---|---|
| private final boolean repairnamespace | |
| usednsstack | back to summary |
|---|---|
| private NamespaceStack usednsstack | |
| StAXStreamWriter | back to summary |
|---|---|
| public StAXStreamWriter() Create a StAXStreamWriter with the default JDOMFactory for creating JDOM Content. | |
| StAXStreamWriter | back to summary |
|---|---|
| public StAXStreamWriter(final JDOMFactory fac, final boolean repairnamespace) Create a StAXStreamWriter with the specified JDOMFactory for creating JDOM Content.
| |
| buildAttribute | back to summary |
|---|---|
| private final void buildAttribute(final String prefix, final String namespaceURI, final String localName, final String value, final boolean withpfx) throws XMLStreamException | |
| buildElement | back to summary |
|---|---|
| private final void buildElement(final String prefix, final String localName, final String namespaceURI, final boolean withpfx, boolean empty) throws XMLStreamException Simple method that implements the empty-element logic without the spec-required null-check logic
| |
| close | back to summary |
|---|---|
| public void close() throws XMLStreamException Implements javax. Doc from javax. Close this writer and free any resources associated with the writer. This must not close the underlying output stream.
| |
| flush | back to summary |
|---|---|
| public void flush() throws XMLStreamException Implements javax. Doc from javax. Write any cached data to the underlying output mechanism.
| |
| flushActiveElement | back to summary |
|---|---|
| private final void flushActiveElement() | |
| flushActiveText | back to summary |
|---|---|
| private final void flushActiveText() | |
| generatePrefix | back to summary |
|---|---|
| private String generatePrefix() | |
| getDocument | back to summary |
|---|---|
| public Document getDocument() Gets the | |
| getNamespaceContext | back to summary |
|---|---|
| public NamespaceContext getNamespaceContext() Implements javax. Doc from javax. Returns the current namespace context.
| |
| getPrefix | back to summary |
|---|---|
| public String getPrefix(final String uri) throws XMLStreamException Implements javax. Doc from javax. Gets the prefix the uri is bound to.
| |
| getProperty | back to summary |
|---|---|
| public Object getProperty(String name) throws IllegalArgumentException Implements javax. Doc from javax. Get the value of a feature/property from the underlying implementation
| |
| resolveAttributeNamespace | back to summary |
|---|---|
| private Namespace resolveAttributeNamespace(String prefix, String namespaceURI, boolean withpfx) throws XMLStreamException | |
| resolveElementNamespace | back to summary |
|---|---|
| private Namespace resolveElementNamespace(String prefix, String namespaceURI, boolean withpfx) throws XMLStreamException | |
| setDefaultNamespace | back to summary |
|---|---|
| public void setDefaultNamespace(final String uri) throws XMLStreamException Implements javax. Doc from javax. Binds a URI to the default namespace This URI is bound in the scope of the current START_ELEMENT / END_ELEMENT pair. If this method is called before a START_ELEMENT has been written the uri is bound in the root scope.
| |
| setNamespaceContext | back to summary |
|---|---|
| public void setNamespaceContext(final NamespaceContext context) throws XMLStreamException Implements javax. Doc from javax. Sets the current namespace context for prefix and uri bindings. This context becomes the root namespace context for writing and will replace the current root namespace context. Subsequent calls to setPrefix and setDefaultNamespace will bind namespaces using the context passed to the method as the root context for resolving namespaces. This method may only be called once at the start of the document. It does not cause the namespaces to be declared. If a namespace URI to prefix mapping is found in the namespace context it is treated as declared and the prefix may be used by the StreamWriter.
| |
| setPrefix | back to summary |
|---|---|
| public void setPrefix(final String prefix, final String uri) throws XMLStreamException Implements javax. Doc from javax. Sets the prefix the uri is bound to. This prefix is bound in the scope of the current START_ELEMENT / END_ELEMENT pair. If this method is called before a START_ELEMENT has been written the prefix is bound in the root scope.
| |
| writeAttribute | back to summary |
|---|---|
| public void writeAttribute(final String localName, final String value) throws XMLStreamException Implements javax. Doc from javax. Writes an attribute to the output stream without a prefix.
| |
| writeAttribute | back to summary |
|---|---|
| public void writeAttribute(final String namespaceURI, final String localName, final String value) throws XMLStreamException Implements javax. Doc from javax. Writes an attribute to the output stream
| |
| writeAttribute | back to summary |
|---|---|
| public void writeAttribute(final String prefix, final String namespaceURI, final String localName, final String value) throws XMLStreamException Implements javax. Doc from javax. Writes an attribute to the output stream
| |
| writeCData | back to summary |
|---|---|
| public void writeCData(final String data) throws XMLStreamException Implements javax. Doc from javax. Writes a CData section
| |
| writeCharacters | back to summary |
|---|---|
| public void writeCharacters(final String chars) throws XMLStreamException Implements javax. Doc from javax. Write text to the output
| |
| writeCharacters | back to summary |
|---|---|
| public void writeCharacters(final char[] chars, final int start, final int len) throws XMLStreamException Implements javax. Doc from javax. Write text to the output
| |
| writeComment | back to summary |
|---|---|
| public void writeComment(final String data) throws XMLStreamException Implements javax. Doc from javax. Writes an xml comment with the data enclosed
| |
| writeDefaultNamespace | back to summary |
|---|---|
| public void writeDefaultNamespace(final String namespaceURI) throws XMLStreamException Implements javax. Doc from javax. Writes the default namespace to the stream
| |
| writeDTD | back to summary |
|---|---|
| public void writeDTD(final String dtd) throws XMLStreamException Implements javax. Doc from javax. Write a DTD section. This string represents the entire doctypedecl production from the XML 1.0 specification.
| |
| writeEmptyElement | back to summary |
|---|---|
| public void writeEmptyElement(final String localName) throws XMLStreamException Implements javax. Doc from javax. Writes an empty element tag to the output
| |
| writeEmptyElement | back to summary |
|---|---|
| public void writeEmptyElement(final String namespaceURI, final String localName) throws XMLStreamException Implements javax. Doc from javax. Writes an empty element tag to the output
| |
| writeEmptyElement | back to summary |
|---|---|
| public void writeEmptyElement(final String prefix, final String localName, final String namespaceURI) throws XMLStreamException Implements javax. Doc from javax. Writes an empty element tag to the output
| |
| writeEndDocument | back to summary |
|---|---|
| public void writeEndDocument() throws XMLStreamException Implements javax. Doc from javax. Closes any start tags and writes corresponding end tags.
| |
| writeEndElement | back to summary |
|---|---|
| public void writeEndElement() throws XMLStreamException Implements javax. Doc from javax. Writes an end tag to the output relying on the internal state of the writer to determine the prefix and local name of the event.
| |
| writeEntityRef | back to summary |
|---|---|
| public void writeEntityRef(final String name) throws XMLStreamException Implements javax. Doc from javax. Writes an entity reference
| |
| writeNamespace | back to summary |
|---|---|
| public void writeNamespace(final String prefix, final String namespaceURI) throws XMLStreamException Implements javax. Doc from javax. Writes a namespace to the output stream If the prefix argument to this method is the empty string, "xmlns", or null this method will delegate to writeDefaultNamespace
| |
| writeProcessingInstruction | back to summary |
|---|---|
| public void writeProcessingInstruction(final String target) throws XMLStreamException Implements javax. Doc from javax. Writes a processing instruction
| |
| writeProcessingInstruction | back to summary |
|---|---|
| public void writeProcessingInstruction(final String target, final String data) throws XMLStreamException Implements javax. Doc from javax. Writes a processing instruction
| |
| writeStartDocument | back to summary |
|---|---|
| public void writeStartDocument() throws XMLStreamException Implements javax. Doc from javax. Write the XML Declaration. Defaults the XML version to 1.0, and the encoding to utf-8
| |
| writeStartDocument | back to summary |
|---|---|
| public void writeStartDocument(final String version) throws XMLStreamException Implements javax. Doc from javax. Write the XML Declaration. Defaults the XML version to 1.0
| |
| writeStartDocument | back to summary |
|---|---|
| public void writeStartDocument(final String encoding, final String version) throws XMLStreamException Implements javax. Doc from javax. Write the XML Declaration. Note that the encoding parameter does not set the actual encoding of the underlying output. That must be set when the instance of the XMLStreamWriter is created using the XMLOutputFactory
| |
| writeStartElement | back to summary |
|---|---|
| public void writeStartElement(final String localName) throws XMLStreamException Implements javax. Doc from javax. Writes a start tag to the output. All writeStartElement methods open a new scope in the internal namespace context. Writing the corresponding EndElement causes the scope to be closed.
| |
| writeStartElement | back to summary |
|---|---|
| public void writeStartElement(final String namespaceURI, final String localName) throws XMLStreamException Implements javax. Doc from javax. Writes a start tag to the output
| |
| writeStartElement | back to summary |
|---|---|
| public void writeStartElement(final String prefix, final String localName, final String namespaceURI) throws XMLStreamException Implements javax. Doc from javax. Writes a start tag to the output
| |