net.sf.xolite.dom
Class DomXMLSerializer

java.lang.Object
  net.sf.xolite.dom.DomXMLSerializer

All Implemented Interfaces:

XMLSerializer

public class DomXMLSerializer
extends Object
implements XMLSerializer

Serializer transforming a java object to a DOM tree.

Constructor Summary

DomXMLSerializer()

DomXMLSerializer(DocumentBuilder docBuilder)

Method Summary

void	attribute(String name, String value) Add an attribute to the element that was just started.
void	attribute(String uri, String localName, String value) Add an attribute to the element that was just started.
void	characters(String text) Add character content of an element.
void	charactersMultiLine(String text) Same as characters but the text (supposed to be multi-line) is formatted to be an indented text block.
void	clearPrefixMapping()
void	endDocument() End the current XML document.
void	endElement(String uri, String localName) End an XML element.
Object	getCustomObject(Object key) Get back any custom object that was put in with the putCustomObject(key, value) method.
Document	getDocument()
void	putCustomObject(Object key, Object value) Put a custom object in an internal Map.
Document	serializeToDOM(XMLSerializable src)
void	simpleElement(String namespaceUri, String localName, String text) This is a helper method useful to add a simpleType element in one call.
void	startDocument() Start an XML document.
void	startElement(String uri, String localName) Start an XML element.
void	startPrefixMapping(String prefix, String namespaceUri) Define a prefix mapping.

Methods inherited from class java.lang.Object

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

Constructor Detail

DomXMLSerializer

public DomXMLSerializer()

DomXMLSerializer

public DomXMLSerializer(DocumentBuilder docBuilder)

Method Detail

clearPrefixMapping

public void clearPrefixMapping()

serializeToDOM

public Document serializeToDOM(XMLSerializable src)
                        throws XMLSerializeException

Throws:

XMLSerializeException

startDocument

public void startDocument()
                   throws XMLSerializeException

Description copied from interface: XMLSerializer

Start an XML document.

Specified by:

startDocument in interface XMLSerializer

Throws:

XMLSerializeException

endDocument

public void endDocument()
                 throws XMLSerializeException

Description copied from interface: XMLSerializer

End the current XML document.

Specified by:

endDocument in interface XMLSerializer

Throws:

XMLSerializeException

getDocument

public Document getDocument()

startPrefixMapping

public void startPrefixMapping(String prefix,
                               String namespaceUri)
                        throws XMLSerializeException

Description copied from interface: XMLSerializer

Define a prefix mapping. This method associate the given prefix to the given namespace. So when a node of the given namespace will be serialized, the given prefix will be used to denote the namespace (and the prefix declaration will be inserted when necessary).

This method should be called for each namespace URI before the first time they are used.

If the given namespace is already associated to another prefix (or the same prefix), this method call is ignored (i.e. first association wins).

If the given prefix is already associated to an other namespace, a new prefix is generated and mapped at the place of the given one.

Specified by:

startPrefixMapping in interface XMLSerializer

Parameters:

prefix - a prefix (can be "" for default prefix mapping)

namespaceUri - a namespace URI

Throws:

XMLSerializeException - if prefix or namespaceUri is null or if required action cannot be done (implementation dependent).

startElement

public void startElement(String uri,
                         String localName)
                  throws XMLSerializeException

Description copied from interface: XMLSerializer

Start an XML element.

Specified by:

startElement in interface XMLSerializer

Parameters:

uri - The element namespace URI (can be null if namespace are not used)

localName - The element local name (a.k.a. NCName)

Throws:

XMLSerializeException - if required action cannot be done (implementation dependent).

attribute

public void attribute(String name,
                      String value)
               throws XMLSerializeException

Description copied from interface: XMLSerializer

Add an attribute to the element that was just started. All the call to this method must immediately follow a startElement call. attribute. This attribute use no namespace.

Specified by:

attribute in interface XMLSerializer

Parameters:

name - The attribute local name (a.k.a. NCName)

value - the attribute value (null is treated as empty string).

Throws:

XMLSerializeException - if you don't call this method just after startElement or if required action cannot be done (implementation dependent).

attribute

public void attribute(String uri,
                      String localName,
                      String value)
               throws XMLSerializeException

Description copied from interface: XMLSerializer

Add an attribute to the element that was just started. All the call to this method must immediately follow a startElement call. attribute

Specified by:

attribute in interface XMLSerializer

Parameters:

uri - The attribute namespace URI. This URI is usually null because most of the time, attributes don't use a namespace.

localName - The attribute local name (a.k.a. NCName)

value - the attribute value (null is treated as empty string).

Throws:

XMLSerializeException - if you don't call this method just after startElement or if required action cannot be done (implementation dependent).

characters

public void characters(String text)
                throws XMLSerializeException

Description copied from interface: XMLSerializer

Add character content of an element. This method must be called between startElement (possibly followed by attribute) and endElement. If this method is called several times for the same element, the texts are concatenated.

Specified by:

characters in interface XMLSerializer

Parameters:

text - text of the currently started element.

Throws:

XMLSerializeException - if you don't call this method just beteween startElement and endElement or if required action cannot be done (implementation dependent).

charactersMultiLine

public void charactersMultiLine(String text)
                         throws XMLSerializeException

Description copied from interface: XMLSerializer

Same as characters but the text (supposed to be multi-line) is formatted to be an indented text block.
The result will look like:

            <tag>
                some text
                spanning multiple
                lines.
            </tag>
 

While usual output would have given:

            <tag>some text
      spanning multiple
      lines.</tag>
 

The original text can be retrieved (when parsing) with the ElementText.getMultilineText(..) method. This method will automatically remove the added space.

Specified by:

charactersMultiLine in interface XMLSerializer

Parameters:

text - the text to serialize in XML

Throws:

XMLSerializeException

See Also:

ElementText.getMultilineText(String, XMLEventParser)

endElement

public void endElement(String uri,
                       String localName)
                throws XMLSerializeException

Description copied from interface: XMLSerializer

End an XML element.

Specified by:

endElement in interface XMLSerializer

Parameters:

uri - The element namespace URI (can be null if namespace are not used)

localName - The element local name (a.k.a. NCName)

Throws:

XMLSerializeException - if required action cannot be done (implementation dependent).

simpleElement

public void simpleElement(String namespaceUri,
                          String localName,
                          String text)
                   throws XMLSerializeException

Description copied from interface: XMLSerializer

This is a helper method useful to add a simpleType element in one call. It is strictly equivalent to the following sequence:

 startElement(namespaceUri, localName);
 characters(text);
 endElement(namespaceUri, localName);
 

Specified by:

simpleElement in interface XMLSerializer

Parameters:

namespaceUri - The element namespace URI (can be null if namespace are not used)

localName - The element local name (a.k.a. NCName)

text - text of the element.

Throws:

XMLSerializeException

getCustomObject

public Object getCustomObject(Object key)

Description copied from interface: XMLSerializer

Get back any custom object that was put in with the putCustomObject(key, value) method.

Specified by:

getCustomObject in interface XMLSerializer

Parameters:

key - key of the custom object.

Returns:

the custom object.

putCustomObject

public void putCustomObject(Object key,
                            Object value)

Description copied from interface: XMLSerializer

Put a custom object in an internal Map.
It can be retrieved later with getCustomObject(key) method.

Specified by:

putCustomObject in interface XMLSerializer

Parameters:

key - key of the custom object.

value - custom object.