org.simpleframework.xml.stream
Class NodeBuilder

java.lang.Object
  extended by org.simpleframework.xml.stream.NodeBuilder

public final class NodeBuilder
extends Object

The NodeBuilder object is used to create either an input node or an output node for a given source or destination. If an InputNode is required for reading an XML document then a reader must be provided to read the content from.

If an OutputNode is required then a destination is required. The provided output node can be used to generate well formed XML to the specified writer.

Author:
Niall Gallagher

Constructor Summary
NodeBuilder()
           
 
Method Summary
static InputNode read(InputStream source)
          This is used to create an InputNode that can be used to read XML from the specified stream.
static InputNode read(Reader source)
          This is used to create an InputNode that can be used to read XML from the specified reader.
static OutputNode write(Writer result)
          This is used to create an OutputNode that can be used to write a well formed XML document.
static OutputNode write(Writer result, Format format)
          This is used to create an OutputNode that can be used to write a well formed XML document.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

NodeBuilder

public NodeBuilder()
Method Detail

read

public static InputNode read(InputStream source)
                      throws Exception
This is used to create an InputNode that can be used to read XML from the specified stream. The stream will be positioned at the root element in the XML document.

Parameters:
source - this contains the contents of the XML source
Throws:
Exception - thrown if there is an I/O exception

read

public static InputNode read(Reader source)
                      throws Exception
This is used to create an InputNode that can be used to read XML from the specified reader. The reader will be positioned at the root element in the XML document.

Parameters:
source - this contains the contents of the XML source
Throws:
Exception - thrown if there is an I/O exception

write

public static OutputNode write(Writer result)
                        throws Exception
This is used to create an OutputNode that can be used to write a well formed XML document. The writer specified will have XML elements, attributes, and text written to it as output nodes are created and populated.

Parameters:
result - this contains the result of the generated XML
Throws:
Exception - this is thrown if there is an I/O error

write

public static OutputNode write(Writer result,
                               Format format)
                        throws Exception
This is used to create an OutputNode that can be used to write a well formed XML document. The writer specified will have XML elements, attributes, and text written to it as output nodes are created and populated.

Parameters:
result - this contains the result of the generated XML
format - this is the format to use for the document
Throws:
Exception - this is thrown if there is an I/O error