|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavanet.staxutils.helpers.StreamWriterDelegate
javanet.staxutils.IndentingXMLStreamWriter
public class IndentingXMLStreamWriter
A filter that indents an XML stream. To apply it, construct a filter that
contains another XMLStreamWriter
, which you pass to the constructor.
Then call methods of the filter instead of the contained stream. For example:
XMLStreamWriter
stream = ... stream = newIndentingXMLStreamWriter
(stream); stream.writeStartDocument(); ...
The filter inserts characters to format the document as an outline, with nested elements indented. Basically, it inserts a line break and whitespace before:
Indentation can be adjusted by setting the newLine and indent properties. But set them to whitespace only, for best results. Non-whitespace is apt to cause problems, for example when this class attempts to insert newLine before the root element.
Field Summary |
---|
Fields inherited from class javanet.staxutils.helpers.StreamWriterDelegate |
---|
out |
Fields inherited from interface javanet.staxutils.Indentation |
---|
DEFAULT_INDENT, NORMAL_END_OF_LINE |
Constructor Summary | |
---|---|
IndentingXMLStreamWriter(XMLStreamWriter out)
|
Method Summary | |
---|---|
protected void |
afterData()
Note that data were written. |
protected void |
afterEndDocument()
Note that a document was ended. |
protected void |
afterEndElement()
Note that an element was ended. |
protected void |
afterMarkup()
Note that markup or indentation was written. |
protected void |
afterStartElement()
Note that an element was started. |
protected void |
beforeEndElement()
Prepare to end an element, by writing a new line and indentation. |
protected void |
beforeMarkup()
Prepare to write markup, by writing a new line and indentation. |
protected void |
beforeStartElement()
Prepare to start an element, by allocating stack space. |
String |
getIndent()
The characters used for one level of indentation. |
static String |
getLineSeparator()
|
String |
getNewLine()
The characters that introduce a new line. |
void |
setIndent(String indent)
Set the characters used for one level of indentation. |
void |
setNewLine(String newLine)
Set the characters that introduce a new line. |
void |
writeCData(String data)
|
void |
writeCharacters(char[] text,
int start,
int len)
|
void |
writeCharacters(String text)
|
void |
writeComment(String data)
|
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 name)
|
protected void |
writeNewLine(int indentation)
Write a line separator followed by indentation. |
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 javanet.staxutils.helpers.StreamWriterDelegate |
---|
close, flush, getNamespaceContext, getPrefix, getProperty, setDefaultNamespace, setNamespaceContext, setPrefix, writeAttribute, writeAttribute, writeAttribute, writeDefaultNamespace, writeNamespace |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public IndentingXMLStreamWriter(XMLStreamWriter out)
Method Detail |
---|
public void setIndent(String indent)
Indentation
Indentation.DEFAULT_INDENT
. "\t" is a popular alternative.
setIndent
in interface Indentation
public String getIndent()
Indentation
getIndent
in interface Indentation
public void setNewLine(String newLine)
Indentation
Indentation.NORMAL_END_OF_LINE
.
getLineSeparator()
() is a popular
alternative.
setNewLine
in interface Indentation
public static String getLineSeparator()
Indentation.NORMAL_END_OF_LINE
if that fails.public String getNewLine()
Indentation
getNewLine
in interface Indentation
public void writeStartDocument() throws XMLStreamException
writeStartDocument
in interface XMLStreamWriter
writeStartDocument
in class StreamWriterDelegate
XMLStreamException
public void writeStartDocument(String version) throws XMLStreamException
writeStartDocument
in interface XMLStreamWriter
writeStartDocument
in class StreamWriterDelegate
XMLStreamException
public void writeStartDocument(String encoding, String version) throws XMLStreamException
writeStartDocument
in interface XMLStreamWriter
writeStartDocument
in class StreamWriterDelegate
XMLStreamException
public void writeDTD(String dtd) throws XMLStreamException
writeDTD
in interface XMLStreamWriter
writeDTD
in class StreamWriterDelegate
XMLStreamException
public void writeProcessingInstruction(String target) throws XMLStreamException
writeProcessingInstruction
in interface XMLStreamWriter
writeProcessingInstruction
in class StreamWriterDelegate
XMLStreamException
public void writeProcessingInstruction(String target, String data) throws XMLStreamException
writeProcessingInstruction
in interface XMLStreamWriter
writeProcessingInstruction
in class StreamWriterDelegate
XMLStreamException
public void writeComment(String data) throws XMLStreamException
writeComment
in interface XMLStreamWriter
writeComment
in class StreamWriterDelegate
XMLStreamException
public void writeEmptyElement(String localName) throws XMLStreamException
writeEmptyElement
in interface XMLStreamWriter
writeEmptyElement
in class StreamWriterDelegate
XMLStreamException
public void writeEmptyElement(String namespaceURI, String localName) throws XMLStreamException
writeEmptyElement
in interface XMLStreamWriter
writeEmptyElement
in class StreamWriterDelegate
XMLStreamException
public void writeEmptyElement(String prefix, String localName, String namespaceURI) throws XMLStreamException
writeEmptyElement
in interface XMLStreamWriter
writeEmptyElement
in class StreamWriterDelegate
XMLStreamException
public void writeStartElement(String localName) throws XMLStreamException
writeStartElement
in interface XMLStreamWriter
writeStartElement
in class StreamWriterDelegate
XMLStreamException
public void writeStartElement(String namespaceURI, String localName) throws XMLStreamException
writeStartElement
in interface XMLStreamWriter
writeStartElement
in class StreamWriterDelegate
XMLStreamException
public void writeStartElement(String prefix, String localName, String namespaceURI) throws XMLStreamException
writeStartElement
in interface XMLStreamWriter
writeStartElement
in class StreamWriterDelegate
XMLStreamException
public void writeCharacters(String text) throws XMLStreamException
writeCharacters
in interface XMLStreamWriter
writeCharacters
in class StreamWriterDelegate
XMLStreamException
public void writeCharacters(char[] text, int start, int len) throws XMLStreamException
writeCharacters
in interface XMLStreamWriter
writeCharacters
in class StreamWriterDelegate
XMLStreamException
public void writeCData(String data) throws XMLStreamException
writeCData
in interface XMLStreamWriter
writeCData
in class StreamWriterDelegate
XMLStreamException
public void writeEntityRef(String name) throws XMLStreamException
writeEntityRef
in interface XMLStreamWriter
writeEntityRef
in class StreamWriterDelegate
XMLStreamException
public void writeEndElement() throws XMLStreamException
writeEndElement
in interface XMLStreamWriter
writeEndElement
in class StreamWriterDelegate
XMLStreamException
public void writeEndDocument() throws XMLStreamException
writeEndDocument
in interface XMLStreamWriter
writeEndDocument
in class StreamWriterDelegate
XMLStreamException
protected void beforeMarkup()
protected void afterMarkup()
protected void afterData()
protected void beforeStartElement()
protected void afterStartElement()
protected void beforeEndElement()
protected void afterEndElement()
protected void afterEndDocument()
protected void writeNewLine(int indentation) throws XMLStreamException
XMLStreamException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |