org.dbunit.util.xml

Class XmlWriter

java.lang.Object

org.dbunit.util.xml.XmlWriter

public class XmlWriter
extends java.lang.Object

Makes writing XML much much easier. Improved from article

Since:

1.0

Version:

$Revision$ $Date$

Author:

Henri Yandell, Peter Cassetta, Last changed by: $Author$

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CDATA_END CDATA end tag: "]]>"
static java.lang.String	CDATA_START CDATA start tag: "
static java.nio.charset.Charset	DEFAULT_CHARSET
static java.lang.String	DEFAULT_ENCODING Default encoding value which is "UTF-8"

Constructor Summary

Constructors

Constructor and Description
XmlWriter(java.io.OutputStream outputStream, java.nio.charset.Charset charset) Create an XmlWriter on top of an existing OutputStream.
XmlWriter(java.io.Writer writer) Create an XmlWriter on top of an existing java.io.Writer.
XmlWriter(java.io.Writer writer, java.nio.charset.Charset charset) Create an XmlWriter on top of an existing java.io.Writer.

Method Summary

Modifier and Type	Method and Description
void	close() Close this writer.
protected java.lang.String	convertCharacterToEntity(char currentChar, boolean literally)
void	enablePrettyPrint(boolean enable) Turn pretty printing on or off.
XmlWriter	endElement() End the current element.
static void	main(java.lang.String[] args)
void	setIndent(java.lang.String indent) Specify the string to prepend to a line for each level of indent.
void	setNewline(java.lang.String newline) Specify the string used to terminate each line when pretty printing.
void	setWriter(java.io.Writer writer, java.nio.charset.Charset charset)
void	setWriter(java.io.Writer writer, java.lang.String encoding) Resets the handler to write a new text document.
static void	test1()
static void	test2()
XmlWriter	writeAttribute(java.lang.String attr, java.lang.String value) Write an attribute out for the current element.
XmlWriter	writeAttribute(java.lang.String attr, java.lang.String value, boolean literally) Write an attribute out for the current element.
XmlWriter	writeCData(java.lang.String cdata) Write out a chunk of CDATA.
XmlWriter	writeComment(java.lang.String comment) Write out a chunk of comment.
XmlWriter	writeDeclaration()
XmlWriter	writeDoctype(java.lang.String systemId, java.lang.String publicId)
XmlWriter	writeElement(java.lang.String name) Begin to write out an element.
XmlWriter	writeElementWithText(java.lang.String name, java.lang.String text) A helper method.
XmlWriter	writeEmptyElement(java.lang.String name) A helper method.
XmlWriter	writeText(java.lang.String text) Output body text.
XmlWriter	writeText(java.lang.String text, boolean literally) Output body text.

Methods inherited from class java.lang.Object

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

Field Detail

CDATA_START

public static final java.lang.String CDATA_START

CDATA start tag: "

See Also:

Constant Field Values

CDATA_END

public static final java.lang.String CDATA_END

CDATA end tag: "]]>"

See Also:

Constant Field Values

DEFAULT_ENCODING

public static final java.lang.String DEFAULT_ENCODING

Default encoding value which is "UTF-8"

See Also:

Constant Field Values

DEFAULT_CHARSET

public static final java.nio.charset.Charset DEFAULT_CHARSET

Constructor Detail

XmlWriter

public XmlWriter(java.io.Writer writer)

Create an XmlWriter on top of an existing java.io.Writer.

XmlWriter

public XmlWriter(java.io.Writer writer,
                 java.nio.charset.Charset charset)

Create an XmlWriter on top of an existing java.io.Writer.

XmlWriter

public XmlWriter(java.io.OutputStream outputStream,
                 java.nio.charset.Charset charset)

Create an XmlWriter on top of an existing OutputStream.

Parameters:

outputStream -

charset - The charset to be used for writing to the given output stream. Can be null. If it is null the DEFAULT_ENCODING is used.

Since:

2.4

Method Detail

enablePrettyPrint

public void enablePrettyPrint(boolean enable)

Turn pretty printing on or off. Pretty printing is enabled by default, but it can be turned off to generate more compact XML.

Parameters:

enable - true to enable, false to disable pretty printing.

setIndent

public void setIndent(java.lang.String indent)

Specify the string to prepend to a line for each level of indent. It is 2 spaces (" ") by default. Some may prefer a single tab ("\t") or a different number of spaces. Specifying an empty string will turn off indentation when pretty printing.

Parameters:

indent - representing one level of indentation while pretty printing.

setNewline

public void setNewline(java.lang.String newline)

Specify the string used to terminate each line when pretty printing. It is a single newline ("\n") by default. Users who need to read generated XML documents in Windows editors like Notepad may wish to set this to a carriage return/newline sequence ("\r\n"). Specifying an empty string will turn off generation of line breaks when pretty printing.

Parameters:

newline - representing the newline sequence when pretty printing.

writeElementWithText

public XmlWriter writeElementWithText(java.lang.String name,
                                      java.lang.String text)
                               throws java.io.IOException

A helper method. It writes out an element which contains only text.

Parameters:

name - String name of tag

text - String of text to go inside the tag

Throws:

java.io.IOException

writeEmptyElement

public XmlWriter writeEmptyElement(java.lang.String name)
                            throws java.io.IOException

A helper method. It writes out empty entities.

Parameters:

name - String name of tag

Throws:

java.io.IOException

writeElement

public XmlWriter writeElement(java.lang.String name)
                       throws java.io.IOException

Begin to write out an element. Unlike the helper tags, this tag will need to be ended with the endElement method.

Parameters:

name - String name of tag

Throws:

java.io.IOException

writeAttribute

public XmlWriter writeAttribute(java.lang.String attr,
                                java.lang.String value)
                         throws java.io.IOException

Write an attribute out for the current element. Any XML characters in the value are escaped. Currently it does not actually throw the exception, but the API is set that way for future changes.

Parameters:

attr - name of attribute.

value - value of attribute.

Throws:

java.io.IOException

See Also:

writeAttribute(String, String, boolean)

writeAttribute

public XmlWriter writeAttribute(java.lang.String attr,
                                java.lang.String value,
                                boolean literally)
                         throws java.io.IOException

Write an attribute out for the current element. Any XML characters in the value are escaped. Currently it does not actually throw the exception, but the API is set that way for future changes.

Parameters:

attr - name of attribute.

value - value of attribute.

literally - If the writer should be literally on the given value which means that meta characters will also be preserved by escaping them. Mainly preserves newlines and tabs.

Throws:

java.io.IOException

endElement

public XmlWriter endElement()
                     throws java.io.IOException

End the current element. This will throw an exception if it is called when there is not a currently open element.

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Close this writer. It does not close the underlying writer, but does throw an exception if there are as yet unclosed tags.

Throws:

java.io.IOException

writeText

public XmlWriter writeText(java.lang.String text)
                    throws java.io.IOException

Output body text. Any XML characters are escaped.

Parameters:

text - The text to be written

Returns:

This writer

Throws:

java.io.IOException

See Also:

writeText(String, boolean)

writeText

public XmlWriter writeText(java.lang.String text,
                           boolean literally)
                    throws java.io.IOException

Output body text. Any XML characters are escaped.

Parameters:

text - The text to be written

literally - If the writer should be literally on the given value which means that meta characters will also be preserved by escaping them. Mainly preserves newlines and tabs.

Returns:

This writer

Throws:

java.io.IOException

writeCData

public XmlWriter writeCData(java.lang.String cdata)
                     throws java.io.IOException

Write out a chunk of CDATA. This helper method surrounds the passed in data with the CDATA tag.

Parameters:

cdata - of CDATA text.

Throws:

java.io.IOException

writeComment

public XmlWriter writeComment(java.lang.String comment)
                       throws java.io.IOException

Write out a chunk of comment. This helper method surrounds the passed in data with the XML comment tag.

Parameters:

comment - of text to comment.

Throws:

java.io.IOException

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException

Throws:

java.io.IOException

test1

public static void test1()
                  throws java.io.IOException

Throws:

java.io.IOException

test2

public static void test2()
                  throws java.io.IOException

Throws:

java.io.IOException

convertCharacterToEntity

protected java.lang.String convertCharacterToEntity(char currentChar,
                                                    boolean literally)

setWriter

public final void setWriter(java.io.Writer writer,
                            java.lang.String encoding)

Resets the handler to write a new text document.

Parameters:

writer - XML text is written to this writer.

encoding - if non-null, and an XML declaration is written, this is the name that will be used for the character encoding.

Throws:

java.lang.IllegalStateException - if the current document hasn't yet ended (i.e. the output stream out is not null)

setWriter

public final void setWriter(java.io.Writer writer,
                            java.nio.charset.Charset charset)

writeDeclaration

public XmlWriter writeDeclaration()
                           throws java.io.IOException

Throws:

java.io.IOException

writeDoctype

public XmlWriter writeDoctype(java.lang.String systemId,
                              java.lang.String publicId)
                       throws java.io.IOException

Throws:

java.io.IOException