Package cdc.util.data.xml

Class XmlDataWriter

java.lang.Object

cdc.util.data.xml.XmlDataWriter

All Implemented Interfaces:

java.io.Closeable, java.io.Flushable, java.lang.AutoCloseable

public class XmlDataWriter
extends java.lang.Object
implements java.io.Closeable, java.io.Flushable

Class used to save data Nodes as XML.

Author:

Damien Carbonne

Field Summary

Fields

Modifier and Type	Field	Description
protected static org.apache.logging.log4j.Logger	LOGGER

Constructor Summary

Constructors

Constructor	Description
XmlDataWriter(XmlWriter writer)
XmlDataWriter(java.io.File file)
XmlDataWriter(java.io.File file, java.lang.String encoding)
XmlDataWriter(java.io.OutputStream os)
XmlDataWriter(java.io.OutputStream os, java.lang.String encoding)
XmlDataWriter(java.io.PrintStream out)
XmlDataWriter(java.io.PrintStream out, java.lang.String encoding)
XmlDataWriter(java.io.Writer writer)
XmlDataWriter(java.lang.String filename)
XmlDataWriter(java.lang.String filename, java.lang.String encoding)

Method Summary

Modifier and Type	Method	Description
void	close()
void	flush()
XmlWriter	getXmlWriter()
static void	print(Document doc, java.io.PrintStream out, java.lang.String indent, boolean close, XmlWriter.Feature... features)	Prints a Document to a PrintStream.
static void	print(Node node, boolean asDocument, java.io.PrintStream out, java.lang.String indent, boolean close, XmlWriter.Feature... features)	Prints a Node to a PrintStream.
static void	save(Document doc, java.io.File file, java.lang.String indent, XmlWriter.Feature... features)	Saves a Document to a File.
static void	save(Document doc, java.io.OutputStream os, java.lang.String indent, XmlWriter.Feature... features)	Saves a Document to an OutputStream.
static void	save(Document doc, java.io.Writer writer, java.lang.String indent, XmlWriter.Feature... features)	Saves a Document to a Writer.
static void	save(Document doc, java.lang.String filename, java.lang.String indent, XmlWriter.Feature... features)	Saves a Document to a File.
static void	save(Node node, boolean asDocument, java.io.File file, java.lang.String indent, XmlWriter.Feature... features)	Saves a Node to a File.
static void	save(Node node, boolean asDocument, java.io.OutputStream os, java.lang.String indent, XmlWriter.Feature... features)	Saves a Node to an OutputStream.
static void	save(Node node, boolean asDocument, java.io.Writer writer, java.lang.String indent, XmlWriter.Feature... features)	Saves a Node to a Writer.
static void	save(Node node, boolean asDocument, java.lang.String filename, java.lang.String indent, XmlWriter.Feature... features)	Saves a Node to a File.
static java.lang.String	toString(Node node, boolean asDocument, java.lang.String indent, XmlWriter.Feature... features)
void	write(Node node)	Writes a node.
static void	write(XmlWriter writer, Node node)	Writes a node to an XmlWriter.
static void	write(XmlWriter writer, Node node, boolean asDocument)	Writes a node to an XmlWriter.

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

protected static final org.apache.logging.log4j.Logger LOGGER

Constructor Detail

XmlDataWriter

public XmlDataWriter(XmlWriter writer)

XmlDataWriter

public XmlDataWriter(java.io.Writer writer)

XmlDataWriter

public XmlDataWriter(java.io.OutputStream os)
              throws java.io.UnsupportedEncodingException

Throws:

java.io.UnsupportedEncodingException

XmlDataWriter

public XmlDataWriter(java.io.OutputStream os,
                     java.lang.String encoding)
              throws java.io.UnsupportedEncodingException

Throws:

java.io.UnsupportedEncodingException

XmlDataWriter

public XmlDataWriter(java.io.PrintStream out)
              throws java.io.UnsupportedEncodingException

Throws:

java.io.UnsupportedEncodingException

XmlDataWriter

public XmlDataWriter(java.io.PrintStream out,
                     java.lang.String encoding)
              throws java.io.UnsupportedEncodingException

Throws:

java.io.UnsupportedEncodingException

XmlDataWriter

public XmlDataWriter(java.lang.String filename)
              throws java.io.FileNotFoundException,
                     java.io.UnsupportedEncodingException

Throws:

java.io.FileNotFoundException

java.io.UnsupportedEncodingException

XmlDataWriter

public XmlDataWriter(java.lang.String filename,
                     java.lang.String encoding)
              throws java.io.FileNotFoundException,
                     java.io.UnsupportedEncodingException

Throws:

java.io.FileNotFoundException

java.io.UnsupportedEncodingException

XmlDataWriter

public XmlDataWriter(java.io.File file)
              throws java.io.FileNotFoundException,
                     java.io.UnsupportedEncodingException

Throws:

java.io.FileNotFoundException

java.io.UnsupportedEncodingException

XmlDataWriter

public XmlDataWriter(java.io.File file,
                     java.lang.String encoding)
              throws java.io.FileNotFoundException,
                     java.io.UnsupportedEncodingException

Throws:

java.io.FileNotFoundException

java.io.UnsupportedEncodingException

Method Detail

getXmlWriter

public final XmlWriter getXmlWriter()

Returns:

The underlying XmlWriter.

write

public void write(Node node)
           throws java.io.IOException

Writes a node.

Parameters:

node - The node.

Throws:

java.io.IOException - When an IO error occurs.

write

public static void write(XmlWriter writer,
                         Node node,
                         boolean asDocument)
                  throws java.io.IOException

Writes a node to an XmlWriter.

Parameters:

writer - The XmlWriter.

node - The node.

asDocument - If true and node is not a document, inserts XML heading <?xml version="1.0" encoding="UTF-8"?> before writing the node.
If false and node is not a document, directly writes the node.
If node is a document, this has no effect.

Throws:

java.io.IOException - When an IO error occurs.

write

public static void write(XmlWriter writer,
                         Node node)
                  throws java.io.IOException

Writes a node to an XmlWriter.

If node is not a document, XML heading <?xml version="1.0" encoding="UTF-8"?> is not inserted.
Use write(XmlWriter, Node, boolean) for that.

Parameters:

writer - The XmlWriter.

node - The node.

Throws:

java.io.IOException - When an IO error occurs.

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException

flush

public void flush()
           throws java.io.IOException

Specified by:

flush in interface java.io.Flushable

Throws:

java.io.IOException

print

public static void print(Node node,
                         boolean asDocument,
                         java.io.PrintStream out,
                         java.lang.String indent,
                         boolean close,
                         XmlWriter.Feature... features)
                  throws java.io.IOException

Prints a Node to a PrintStream.

Parameters:

node - The node.

asDocument - If true and node is not a document, inserts XML heading <?xml version="1.0" encoding="UTF-8"?> before writing the node.
If false and node is not a document, directly writes the node.
If node is a document, this has no effect.

out - The PrintStream.

indent - Indent string. If not null, pretty printing is enabled.

close - If true, out is closed in the end.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

print

public static void print(Document doc,
                         java.io.PrintStream out,
                         java.lang.String indent,
                         boolean close,
                         XmlWriter.Feature... features)
                  throws java.io.IOException

Prints a Document to a PrintStream.

Parameters:

doc - The document.

out - The PrintStream.

indent - Indent string. If not null, pretty printing is enabled.

close - If true, out is closed in the end.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

save

public static void save(Node node,
                        boolean asDocument,
                        java.io.Writer writer,
                        java.lang.String indent,
                        XmlWriter.Feature... features)
                 throws java.io.IOException

Saves a Node to a Writer.

Parameters:

node - The node.

asDocument - If true and node is not a document, inserts XML heading <?xml version="1.0" encoding="UTF-8"?> before writing the node.
If false and node is not a document, directly writes the node.
If node is a document, this has no effect.

writer - The writer.

indent - Indent string. If not null, pretty printing is enabled.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

save

public static void save(Document doc,
                        java.io.Writer writer,
                        java.lang.String indent,
                        XmlWriter.Feature... features)
                 throws java.io.IOException

Saves a Document to a Writer.

Parameters:

doc - The document.

writer - The writer.

indent - Indent string. If not null, pretty printing is enabled.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

save

public static void save(Node node,
                        boolean asDocument,
                        java.io.OutputStream os,
                        java.lang.String indent,
                        XmlWriter.Feature... features)
                 throws java.io.IOException

Saves a Node to an OutputStream.

Parameters:

node - The node.

asDocument - If true and node is not a document, inserts XML heading <?xml version="1.0" encoding="UTF-8"?> before writing the node.
If false and node is not a document, directly writes the node.
If node is a document, this has no effect.

os - The output stream.

indent - Indent string. If not null, pretty printing is enabled.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

save

public static void save(Document doc,
                        java.io.OutputStream os,
                        java.lang.String indent,
                        XmlWriter.Feature... features)
                 throws java.io.IOException

Saves a Document to an OutputStream.

Parameters:

doc - The document.

os - The output stream.

indent - Indent string. If not null, pretty printing is enabled.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

save

public static void save(Node node,
                        boolean asDocument,
                        java.lang.String filename,
                        java.lang.String indent,
                        XmlWriter.Feature... features)
                 throws java.io.IOException

Saves a Node to a File.

Parameters:

node - The node.

asDocument - If true and node is not a document, inserts XML heading <?xml version="1.0" encoding="UTF-8"?> before writing the node.
If false and node is not a document, directly writes the node.
If node is a document, this has no effect.

filename - The file name.

indent - Indent string. If not null, pretty printing is enabled.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

save

public static void save(Document doc,
                        java.lang.String filename,
                        java.lang.String indent,
                        XmlWriter.Feature... features)
                 throws java.io.IOException

Saves a Document to a File.

Parameters:

doc - The document.

filename - The file name.

indent - Indent string. If not null, pretty printing is enabled.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

save

public static void save(Node node,
                        boolean asDocument,
                        java.io.File file,
                        java.lang.String indent,
                        XmlWriter.Feature... features)
                 throws java.io.IOException

Saves a Node to a File.

Parameters:

node - The node.

asDocument - If true and node is not a document, inserts XML heading <?xml version="1.0" encoding="UTF-8"?> before writing the node.
If false and node is not a document, directly writes the node.
If node is a document, this has no effect.

file - The file.

indent - Indent string. If not null, pretty printing is enabled.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

save

public static void save(Document doc,
                        java.io.File file,
                        java.lang.String indent,
                        XmlWriter.Feature... features)
                 throws java.io.IOException

Saves a Document to a File.

Parameters:

doc - The document.

file - The file.

indent - Indent string. If not null, pretty printing is enabled.

features - The XmlWriter features to enable.

Throws:

java.io.IOException - When an IO error occurs.

toString

public static java.lang.String toString(Node node,
                                        boolean asDocument,
                                        java.lang.String indent,
                                        XmlWriter.Feature... features)