Class StaxWriter

java.lang.Object

com.thoughtworks.xstream.io.AbstractWriter

com.thoughtworks.xstream.io.xml.AbstractXmlWriter

com.thoughtworks.xstream.io.xml.StaxWriter

All Implemented Interfaces:

ExtendedHierarchicalStreamWriter, HierarchicalStreamWriter, XmlFriendlyWriter

public class StaxWriter
extends AbstractXmlWriter

A stream writing that outputs to a StAX stream writer

Version:

$Revision$

Field Summary

Fields

Modifier and Type	Field	Description
private boolean	namespaceRepairingMode
private final XMLStreamWriter	out
private final QNameMap	qnameMap
private int	tagDepth
private final boolean	writeEnclosingDocument

Constructor Summary

Constructors

Constructor	Description
StaxWriter(QNameMap qnameMap, XMLStreamWriter out)
StaxWriter(QNameMap qnameMap, XMLStreamWriter out, boolean writeEnclosingDocument, boolean namespaceRepairingMode)	Allows a StaxWriter to be created for partial XML output
StaxWriter(QNameMap qnameMap, XMLStreamWriter out, boolean writeEnclosingDocument, boolean namespaceRepairingMode, NameCoder nameCoder)	Allows a StaxWriter to be created for partial XML output
StaxWriter(QNameMap qnameMap, XMLStreamWriter out, boolean writeEnclosingDocument, boolean namespaceRepairingMode, XmlFriendlyReplacer replacer)	Deprecated. As of 1.4 use StaxWriter(QNameMap, XMLStreamWriter, boolean, boolean, NameCoder) instead
StaxWriter(QNameMap qnameMap, XMLStreamWriter out, NameCoder nameCoder)	Allows a StaxWriter to be created for partial XML output

Method Summary

Modifier and Type	Method	Description
void	addAttribute(String name, String value)
void	close()	Call this method when you're finished with me
void	endNode()
void	flush()	Flush the writer, if necessary.
protected QNameMap	getQNameMap()
protected XMLStreamWriter	getXMLStreamWriter()
boolean	isNamespaceRepairingMode()	Is StAX namespace repairing mode on or off?
void	setValue(String text)	Write the value (text content) of the current node.
void	startNode(String name)

Methods inherited from class AbstractXmlWriter

escapeXmlName

Methods inherited from class AbstractWriter

encodeAttribute, encodeNode, startNode, underlyingWriter

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

qnameMap

private final QNameMap qnameMap

out

private final XMLStreamWriter out

writeEnclosingDocument

private final boolean writeEnclosingDocument

namespaceRepairingMode

private boolean namespaceRepairingMode

tagDepth

private int tagDepth

Constructor Details

StaxWriter

public StaxWriter(QNameMap qnameMap,
 XMLStreamWriter out)
           throws XMLStreamException

Throws:

XMLStreamException

StaxWriter

public StaxWriter(QNameMap qnameMap,
 XMLStreamWriter out,
 NameCoder nameCoder)
           throws XMLStreamException

Allows a StaxWriter to be created for partial XML output

Parameters:

qnameMap - is the mapper of Java class names to QNames

out - the stream to output to

nameCoder - the xml-friendly replacer to escape Java names

Throws:

XMLStreamException - if the events could not be written to the output

Since:

1.4

StaxWriter

public StaxWriter(QNameMap qnameMap,
 XMLStreamWriter out,
 boolean writeEnclosingDocument,
 boolean namespaceRepairingMode,
 NameCoder nameCoder)
           throws XMLStreamException

Allows a StaxWriter to be created for partial XML output

Parameters:

qnameMap - is the mapper of Java class names to QNames

out - the stream to output to

writeEnclosingDocument - a flag to indicate whether or not the start/end document events should be written

namespaceRepairingMode - a flag to enable StAX' namespace repairing mode

nameCoder - the xml-friendly replacer to escape Java names

Throws:

XMLStreamException - if the events could not be written to the output

Since:

1.4

StaxWriter

public StaxWriter(QNameMap qnameMap,
 XMLStreamWriter out,
 boolean writeEnclosingDocument,
 boolean namespaceRepairingMode)
           throws XMLStreamException

Allows a StaxWriter to be created for partial XML output

Parameters:

qnameMap - is the mapper of Java class names to QNames

out - the stream to output to

writeEnclosingDocument - a flag to indicate whether or not the start/end document events should be written

Throws:

XMLStreamException - if the events could not be written to the output

StaxWriter

public StaxWriter(QNameMap qnameMap,
 XMLStreamWriter out,
 boolean writeEnclosingDocument,
 boolean namespaceRepairingMode,
 XmlFriendlyReplacer replacer)
           throws XMLStreamException

Deprecated.

As of 1.4 use StaxWriter(QNameMap, XMLStreamWriter, boolean, boolean, NameCoder) instead

Allows a StaxWriter to be created for partial XML output

Parameters:

qnameMap - is the mapper of Java class names to QNames

out - the stream to output to

writeEnclosingDocument - a flag to indicate whether or not the start/end document events should be written

replacer - the xml-friendly replacer to escape Java names

Throws:

XMLStreamException - if the events could not be written to the output

Since:

1.2

Method Details

flush

public void flush()

Description copied from interface: HierarchicalStreamWriter

Flush the writer, if necessary.

close

public void close()

Call this method when you're finished with me

addAttribute

public void addAttribute(String name,
 String value)

endNode

public void endNode()

setValue

public void setValue(String text)

Description copied from interface: HierarchicalStreamWriter

Write the value (text content) of the current node.

startNode

public void startNode(String name)

isNamespaceRepairingMode

public boolean isNamespaceRepairingMode()

Is StAX namespace repairing mode on or off?

getQNameMap

protected QNameMap getQNameMap()

getXMLStreamWriter

protected XMLStreamWriter getXMLStreamWriter()