jdk7u.jaxp.xml.external.stream.writers

Class XMLStreamWriterImpl

java.lang.Object

java.util.AbstractMap

jdk7u.jaxp.xml.external.stream.writers.XMLStreamWriterImpl

All Implemented Interfaces:

Map, XMLStreamWriter

public final class XMLStreamWriterImpl
extends AbstractMap
implements XMLStreamWriter

This class implements a StAX XMLStreamWriter. It extends AbstractMap in order to support a getter for implementation-specific properties. For example, you can get the underlying OutputStream by casting an instance of this class to Map and calling getProperty(OUTPUTSTREAM_PROPERTY).

Author:

Neeraj Bajaj, K.Venugopal, Santiago.Pericas-Geertsen@sun.com, Sunitha.Reddy@sun.com

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	XMLStreamWriterImpl.ElementStack

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
static String	CLOSE_EMPTY_ELEMENT
static char	CLOSE_END_TAG
static char	CLOSE_START_TAG
static String	DEFAULT_ENCODING
static String	DEFAULT_XML_VERSION
static String	DEFAULT_XMLDECL
static String	END_CDATA
static String	END_COMMENT
static String	OPEN_END_TAG
static char	OPEN_START_TAG
static String	OUTPUTSTREAM_PROPERTY
static String	SPACE
static String	START_CDATA
static String	START_COMMENT
static String	UTF_8

Constructor Summary

Constructors

Constructor and Description
XMLStreamWriterImpl(OutputStream outputStream, PropertyManager props) Creates a new instance of XMLStreamWriterImpl.
XMLStreamWriterImpl(OutputStream outputStream, String encoding, PropertyManager props) Creates a new instance of XMLStreamWriterImpl.
XMLStreamWriterImpl(StreamResult sr, String encoding, PropertyManager props) Creates a new instance of XMLStreamWriterImpl using a StreamResult.
XMLStreamWriterImpl(Writer writer, PropertyManager props) Creates a new instance of XMLStreamWriterImpl using a Writer.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canReuse() Can this instance be reused
void	close() Close this XMLStreamWriter by closing underlying writer.
boolean	containsKey(Object key)
Set	entrySet()
boolean	equals(Object obj) Overrides the method defined in AbstractMap This is required to satisfy the contract for hashCode.
void	flush() Flush this XMLStreamWriter by flushin underlying writer.
Object	get(Object key) Returns the value associated to an implementation-specific property.
boolean	getEscapeCharacters()
NamespaceContext	getNamespaceContext() Return NamespaceContext being used by the writer.
String	getPrefix(String uri) Return a prefix associated with specified uri, or null if the uri is unknown.
Object	getProperty(String str) Returns value associated with the specified property name.
int	hashCode() Overrides the method defined in AbstractMap This is required by the toString() method
boolean	isEmpty()
protected void	repair() Correct's namespaces as per requirements of isReparisingNamespace property.
void	reset() Reset this instance so that it can be re-used.
void	setDefaultNamespace(String uri) Set the specified URI as default namespace in the current namespace context.
void	setEscapeCharacters(boolean escape)
void	setNamespaceContext(NamespaceContext namespaceContext) Sets the current NamespaceContext for prefix and uri bindings.
void	setOutput(StreamResult sr, String encoding) Use a StreamResult to initialize the output for this XMLStreamWriter.
void	setPrefix(String prefix, String uri) Sets the prefix the uri is bound to.
int	size()
String	toString() Overrides the method defined in AbstractMap which is not completely implemented.
void	writeAttribute(String localName, String value)
void	writeAttribute(String namespaceURI, String localName, String value)
void	writeAttribute(String prefix, String namespaceURI, String localName, String value)
void	writeCData(String cdata)
void	writeCharacters(char[] data, int start, int len)
void	writeCharacters(String data)
void	writeComment(String comment)
void	writeDefaultNamespace(String namespaceURI)
void	writeDTD(String dtd)
void	writeEmptyElement(String localName)
void	writeEmptyElement(String namespaceURI, String localName)
void	writeEmptyElement(String prefix, String localName, String namespaceURI)
void	writeEndDocument()
void	writeEndElement()
void	writeEntityRef(String refName)
void	writeNamespace(String prefix, String namespaceURI) Write a Namespace declaration.
void	writeProcessingInstruction(String target)
void	writeProcessingInstruction(String target, String data)
void	writeStartDocument()
void	writeStartDocument(String version)
void	writeStartDocument(String encoding, String version)
void	writeStartElement(String localName)
void	writeStartElement(String namespaceURI, String localName)
void	writeStartElement(String prefix, String localName, String namespaceURI)

Methods inherited from class java.util.AbstractMap

clear, clone, containsValue, keySet, put, putAll, remove, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

START_COMMENT

public static final String START_COMMENT

See Also:

Constant Field Values

END_COMMENT

public static final String END_COMMENT

See Also:

Constant Field Values

DEFAULT_ENCODING

public static final String DEFAULT_ENCODING

See Also:

Constant Field Values

DEFAULT_XMLDECL

public static final String DEFAULT_XMLDECL

See Also:

Constant Field Values

DEFAULT_XML_VERSION

public static final String DEFAULT_XML_VERSION

See Also:

Constant Field Values

CLOSE_START_TAG

public static final char CLOSE_START_TAG

See Also:

Constant Field Values

OPEN_START_TAG

public static final char OPEN_START_TAG

See Also:

Constant Field Values

OPEN_END_TAG

public static final String OPEN_END_TAG

See Also:

Constant Field Values

CLOSE_END_TAG

public static final char CLOSE_END_TAG

See Also:

Constant Field Values

START_CDATA

public static final String START_CDATA

See Also:

Constant Field Values

END_CDATA

public static final String END_CDATA

See Also:

Constant Field Values

CLOSE_EMPTY_ELEMENT

public static final String CLOSE_EMPTY_ELEMENT

See Also:

Constant Field Values

SPACE

public static final String SPACE

See Also:

Constant Field Values

UTF_8

public static final String UTF_8

See Also:

Constant Field Values

OUTPUTSTREAM_PROPERTY

public static final String OUTPUTSTREAM_PROPERTY

See Also:

Constant Field Values

Constructor Detail

XMLStreamWriterImpl

public XMLStreamWriterImpl(OutputStream outputStream,
                   PropertyManager props)
                    throws IOException

Creates a new instance of XMLStreamWriterImpl. Uses platform's default encoding.

Parameters:

outputStream - Underlying stream to write the bytes to

props - Properties used by this writer

Throws:

IOException

XMLStreamWriterImpl

public XMLStreamWriterImpl(OutputStream outputStream,
                   String encoding,
                   PropertyManager props)
                    throws IOException

Creates a new instance of XMLStreamWriterImpl.

Parameters:

outputStream - Underlying stream to write the bytes

encoding - Encoding used to convert chars into bytes

props - Properties used by this writer

Throws:

IOException

XMLStreamWriterImpl

public XMLStreamWriterImpl(Writer writer,
                   PropertyManager props)
                    throws IOException

Creates a new instance of XMLStreamWriterImpl using a Writer.

Parameters:

writer - Underlying writer to which chars are written

props - Properties used by this writer

Throws:

IOException

XMLStreamWriterImpl

public XMLStreamWriterImpl(StreamResult sr,
                   String encoding,
                   PropertyManager props)
                    throws IOException

Creates a new instance of XMLStreamWriterImpl using a StreamResult. A StreamResult encasupates an OutputStream, a Writer or a SystemId.

Parameters:

writer - Underlying writer to which chars are written

props - Properties used by this writer

Throws:

IOException

Method Detail

reset

public void reset()

Reset this instance so that it can be re-used. Do not read properties again. The method setOutput(StreamResult, encoding) must be called after this one.

setOutput

public void setOutput(StreamResult sr,
             String encoding)
               throws IOException

Use a StreamResult to initialize the output for this XMLStreamWriter. Check for OutputStream, Writer and then systemId, in that order.

Parameters:

sr - StreamResult encapsulating output information

encoding - Encoding to be used except when a Writer is available

Throws:

IOException

canReuse

public boolean canReuse()

Can this instance be reused

Returns:

boolean boolean value to indicate if this instance can be reused or not

setEscapeCharacters

public void setEscapeCharacters(boolean escape)

getEscapeCharacters

public boolean getEscapeCharacters()

close

public void close()
           throws XMLStreamException

Close this XMLStreamWriter by closing underlying writer.

Specified by:

close in interface XMLStreamWriter

Throws:

XMLStreamException

flush

public void flush()
           throws XMLStreamException

Flush this XMLStreamWriter by flushin underlying writer.

Specified by:

flush in interface XMLStreamWriter

Throws:

XMLStreamException

getNamespaceContext

public NamespaceContext getNamespaceContext()

Return NamespaceContext being used by the writer.

Specified by:

getNamespaceContext in interface XMLStreamWriter

Returns:

NamespaceContext

getPrefix

public String getPrefix(String uri)
                 throws XMLStreamException

Return a prefix associated with specified uri, or null if the uri is unknown.

Specified by:

getPrefix in interface XMLStreamWriter

Parameters:

uri - The namespace uri

Throws:

XMLStreamException - if uri specified is "" or null

getProperty

public Object getProperty(String str)
                   throws IllegalArgumentException

Returns value associated with the specified property name.

Specified by:

getProperty in interface XMLStreamWriter

Parameters:

str - Property name

Returns:

value associated with the specified property.

Throws:

IllegalArgumentException - if the specified property is not supported

setDefaultNamespace

public void setDefaultNamespace(String uri)
                         throws XMLStreamException

Set the specified URI as default namespace in the current namespace context.

Specified by:

setDefaultNamespace in interface XMLStreamWriter

Parameters:

uri - Namespace URI

Throws:

XMLStreamException

setNamespaceContext

public void setNamespaceContext(NamespaceContext namespaceContext)
                         throws XMLStreamException

Sets the current NamespaceContext 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 XMLStreamWriter.

Specified by:

setNamespaceContext in interface XMLStreamWriter

Parameters:

namespaceContext - the namespace context to use for this writer, may not be null

Throws:

XMLStreamException

setPrefix

public void setPrefix(String prefix,
             String uri)
               throws XMLStreamException

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.

Specified by:

setPrefix in interface XMLStreamWriter

Parameters:

prefix -

uri -

Throws:

XMLStreamException

writeAttribute

public void writeAttribute(String localName,
                  String value)
                    throws XMLStreamException

Specified by:

writeAttribute in interface XMLStreamWriter

Throws:

XMLStreamException

writeAttribute

public void writeAttribute(String namespaceURI,
                  String localName,
                  String value)
                    throws XMLStreamException

Specified by:

writeAttribute in interface XMLStreamWriter

Throws:

XMLStreamException

writeAttribute

public void writeAttribute(String prefix,
                  String namespaceURI,
                  String localName,
                  String value)
                    throws XMLStreamException

Specified by:

writeAttribute in interface XMLStreamWriter

Throws:

XMLStreamException

writeCData

public void writeCData(String cdata)
                throws XMLStreamException

Specified by:

writeCData in interface XMLStreamWriter

Throws:

XMLStreamException

writeCharacters

public void writeCharacters(String data)
                     throws XMLStreamException

Specified by:

writeCharacters in interface XMLStreamWriter

Throws:

XMLStreamException

writeCharacters

public void writeCharacters(char[] data,
                   int start,
                   int len)
                     throws XMLStreamException

Specified by:

writeCharacters in interface XMLStreamWriter

Throws:

XMLStreamException

writeComment

public void writeComment(String comment)
                  throws XMLStreamException

Specified by:

writeComment in interface XMLStreamWriter

Throws:

XMLStreamException

writeDTD

public void writeDTD(String dtd)
              throws XMLStreamException

Specified by:

writeDTD in interface XMLStreamWriter

Throws:

XMLStreamException

writeDefaultNamespace

public void writeDefaultNamespace(String namespaceURI)
                           throws XMLStreamException

Specified by:

writeDefaultNamespace in interface XMLStreamWriter

Throws:

XMLStreamException

writeEmptyElement

public void writeEmptyElement(String localName)
                       throws XMLStreamException

Specified by:

writeEmptyElement in interface XMLStreamWriter

Throws:

XMLStreamException

writeEmptyElement

public void writeEmptyElement(String namespaceURI,
                     String localName)
                       throws XMLStreamException

Specified by:

writeEmptyElement in interface XMLStreamWriter

Throws:

XMLStreamException

writeEmptyElement

public void writeEmptyElement(String prefix,
                     String localName,
                     String namespaceURI)
                       throws XMLStreamException

Specified by:

writeEmptyElement in interface XMLStreamWriter

Throws:

XMLStreamException

writeEndDocument

public void writeEndDocument()
                      throws XMLStreamException

Specified by:

writeEndDocument in interface XMLStreamWriter

Throws:

XMLStreamException

writeEndElement

public void writeEndElement()
                     throws XMLStreamException

Specified by:

writeEndElement in interface XMLStreamWriter

Throws:

XMLStreamException

writeEntityRef

public void writeEntityRef(String refName)
                    throws XMLStreamException

Specified by:

writeEntityRef in interface XMLStreamWriter

Throws:

XMLStreamException

writeNamespace

public void writeNamespace(String prefix,
                  String namespaceURI)
                    throws XMLStreamException

Write a Namespace declaration. If namespaceURI == null, then it is assumed to be equivilent to XMLConstants.NULL_NS_URI, i.e. there is no Namespace.

Specified by:

writeNamespace in interface XMLStreamWriter

Parameters:

prefix - Prefix to bind.

namespaceURI - NamespaceURI to declare.

Throws:

XMLStreamException

See Also:

Namespaces in XML, 5.2 Namespace Defaulting

writeProcessingInstruction

public void writeProcessingInstruction(String target)
                                throws XMLStreamException

Specified by:

writeProcessingInstruction in interface XMLStreamWriter

Throws:

XMLStreamException

writeProcessingInstruction

public void writeProcessingInstruction(String target,
                              String data)
                                throws XMLStreamException

Specified by:

writeProcessingInstruction in interface XMLStreamWriter

Parameters:

target -

data -

Throws:

XMLStreamException

writeStartDocument

public void writeStartDocument()
                        throws XMLStreamException

Specified by:

writeStartDocument in interface XMLStreamWriter

Throws:

XMLStreamException

writeStartDocument

public void writeStartDocument(String version)
                        throws XMLStreamException

Specified by:

writeStartDocument in interface XMLStreamWriter

Parameters:

version -

Throws:

XMLStreamException

writeStartDocument

public void writeStartDocument(String encoding,
                      String version)
                        throws XMLStreamException

Specified by:

writeStartDocument in interface XMLStreamWriter

Parameters:

encoding -

version -

Throws:

XMLStreamException

writeStartElement

public void writeStartElement(String localName)
                       throws XMLStreamException

Specified by:

writeStartElement in interface XMLStreamWriter

Parameters:

localName -

Throws:

XMLStreamException

writeStartElement

public void writeStartElement(String namespaceURI,
                     String localName)
                       throws XMLStreamException

Specified by:

writeStartElement in interface XMLStreamWriter

Parameters:

namespaceURI -

localName -

Throws:

XMLStreamException

writeStartElement

public void writeStartElement(String prefix,
                     String localName,
                     String namespaceURI)
                       throws XMLStreamException

Specified by:

writeStartElement in interface XMLStreamWriter

Parameters:

prefix -

localName -

namespaceURI -

Throws:

XMLStreamException

repair

protected void repair()

Correct's namespaces as per requirements of isReparisingNamespace property.

size

public int size()

Specified by:

size in interface Map

Overrides:

size in class AbstractMap

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map

Overrides:

isEmpty in class AbstractMap

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map

Overrides:

containsKey in class AbstractMap

get

public Object get(Object key)

Returns the value associated to an implementation-specific property.

Specified by:

get in interface Map

Overrides:

get in class AbstractMap

entrySet

public Set entrySet()

Specified by:

entrySet in interface Map

Specified by:

entrySet in class AbstractMap

toString

public String toString()

Overrides the method defined in AbstractMap which is not completely implemented. Calling toString() in AbstractMap would cause an unsupported exection to be thrown.

Overrides:

toString in class AbstractMap

hashCode

public int hashCode()

Overrides the method defined in AbstractMap This is required by the toString() method

Specified by:

hashCode in interface Map

Overrides:

hashCode in class AbstractMap

equals

public boolean equals(Object obj)

Overrides the method defined in AbstractMap This is required to satisfy the contract for hashCode.

Specified by:

equals in interface Map

Overrides:

equals in class AbstractMap