Close this writer and free any resources associated with the writer.

  Close this writer and free any resources associated with the
writer. This must not close the underlying output stream.
Throws:
- XMLStreamException -

  Write any cached data to the underlying output mechanism.

  Write any cached data to the underlying output mechanism.
Throws:
- XMLStreamException -

  Returns the current namespace context.

  Returns the current namespace context.
Returns: the current NamespaceContext

  Gets the prefix the uri is bound to

  Gets the prefix the uri is bound to
Returns: the prefix or null
Throws:
- XMLStreamException -

  Get the value of a feature/property from the underlying implementation

  Get the value of a feature/property from the underlying implementation
Returns: The value of the property
Parameters:
- name - The name of the property, may not be null
Throws:
- IllegalArgumentException - if the property is not supported
- NullPointerException - if the name is null

  Binds a URI to the default namespace This URI is bound in the scope of the current START_ELEMENT / END_ELEMENT pair.

  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.
Parameters:
- uri - the uri to bind to the default namespace, may be null
Throws:
- XMLStreamException -

  Sets the current namespace context for prefix and uri bindings.

  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.
Parameters:
- context - the namespace context to use for this writer, may not be null
Throws:
- XMLStreamException -

  Sets the prefix the uri is bound to.

  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.
Parameters:
- prefix - the prefix to bind to the uri, may not be null
- uri - the uri to bind to the prefix, may be null
Throws:
- XMLStreamException -

  Writes an attribute to the output stream without a prefix.

  Writes an attribute to the output stream without
a prefix.
Parameters:
- localName - the local name of the attribute
- value - the value of the attribute
Throws:
- IllegalStateException - if the current state does not allow Attribute writing
- XMLStreamException -

  Writes an attribute to the output stream

  Writes an attribute to the output stream
Parameters:
- namespaceURI - the uri of the prefix for this attribute
- localName - the local name of the attribute
- value - the value of the attribute
Throws:
- IllegalStateException - if the current state does not allow Attribute writing
- XMLStreamException - if the namespace URI has not been bound to a prefix and javax.xml.stream.isRepairingNamespaces has not been set to true

  Writes an attribute to the output stream

  Writes an attribute to the output stream
Parameters:
- prefix - the prefix for this attribute
- namespaceURI - the uri of the prefix for this attribute
- localName - the local name of the attribute
- value - the value of the attribute
Throws:
- IllegalStateException - if the current state does not allow Attribute writing
- XMLStreamException - if the namespace URI has not been bound to a prefix and javax.xml.stream.isRepairingNamespaces has not been set to true

  Writes a CData section

  Writes a CData section
Parameters:
- data - the data contained in the CData Section, may not be null
Throws:
- XMLStreamException -

  Write text to the output

  Write text to the output
Parameters:
- text - the value to write
- start - the starting position in the array
- len - the number of characters to write
Throws:
- XMLStreamException -

  Write text to the output

  Write text to the output
Parameters:
- text - the value to write
Throws:
- XMLStreamException -

  Writes an xml comment with the data enclosed

  Writes an xml comment with the data enclosed
Parameters:
- data - the data contained in the comment, may be null
Throws:
- XMLStreamException -

  Writes the default namespace to the stream

  Writes the default namespace to the stream
Parameters:
- namespaceURI - the uri to bind the default namespace to
Throws:
- IllegalStateException - if the current state does not allow Namespace writing
- XMLStreamException -

  Write a DTD section.

  Write a DTD section. This string represents the entire doctypedecl production
from the XML 1.0 specification.
Parameters:
- dtd - the DTD to be written
Throws:
- XMLStreamException -

  Writes an empty element tag to the output

  Writes an empty element tag to the output
Parameters:
- localName - local name of the tag, may not be null
Throws:
- XMLStreamException -

  Writes an empty element tag to the output

  Writes an empty element tag to the output
Parameters:
- namespaceURI - the uri to bind the tag to, may not be null
- localName - local name of the tag, may not be null
Throws:
- XMLStreamException - if the namespace URI has not been bound to a prefix and javax.xml.stream.isRepairingNamespaces has not been set to true

  Writes an empty element tag to the output

  Writes an empty element tag to the output
Parameters:
- prefix - the prefix of the tag, may not be null
- localName - local name of the tag, may not be null
- namespaceURI - the uri to bind the tag to, may not be null
Throws:
- XMLStreamException -

  Closes any start tags and writes corresponding end tags.

  Closes any start tags and writes corresponding end tags.
Throws:
- XMLStreamException -

  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.

  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.
Throws:
- XMLStreamException -

  Writes an entity reference

  Writes an entity reference
Parameters:
- name - the name of the entity
Throws:
- XMLStreamException -

  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

  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
Parameters:
- prefix - the prefix to bind this namespace to
- namespaceURI - the uri to bind the prefix to
Throws:
- IllegalStateException - if the current state does not allow Namespace writing
- XMLStreamException -

  Writes a processing instruction

  Writes a processing instruction
Parameters:
- target - the target of the processing instruction, may not be null
Throws:
- XMLStreamException -

  Writes a processing instruction

  Writes a processing instruction
Parameters:
- target - the target of the processing instruction, may not be null
- data - the data contained in the processing instruction, may not be null
Throws:
- XMLStreamException -

  Write the XML Declaration.

  Write the XML Declaration. Defaults the XML version to 1.0, and the encoding to utf-8
Throws:
- XMLStreamException -

  Write the XML Declaration.

  Write the XML Declaration. Defaults the XML version to 1.0
Parameters:
- version - version of the xml document
Throws:
- XMLStreamException -

  Write the XML Declaration.

  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
Parameters:
- encoding - encoding of the xml declaration
- version - version of the xml document
Throws:
- XMLStreamException - If given encoding does not match encoding of the underlying stream

  Writes a start tag to the output.

  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.
Parameters:
- localName - local name of the tag, may not be null
Throws:
- XMLStreamException -

  Writes a start tag to the output

  Writes a start tag to the output
Parameters:
- namespaceURI - the namespaceURI of the prefix to use, may not be null
- localName - local name of the tag, may not be null
Throws:
- XMLStreamException - if the namespace URI has not been bound to a prefix and javax.xml.stream.isRepairingNamespaces has not been set to true

  Writes a start tag to the output

  Writes a start tag to the output
Parameters:
- localName - local name of the tag, may not be null
- prefix - the prefix of the tag, may not be null
- namespaceURI - the uri to bind the prefix to, may not be null
Throws:
- XMLStreamException -