net.sf.practicalxml.converter.bean

Class Bean2XmlConverter

java.lang.Object

net.sf.practicalxml.converter.bean.Bean2XmlConverter

public class Bean2XmlConverter
extends Object

Driver class for converting a Java bean into an XML DOM. Normal usage is to create a single instance of this class with desired options, then use it for multiple conversions. This class is thread-safe.

Note: this class is intended to convert simple data transfer beans, using those objects' public getters and setters.

Since:

1.1

Constructor Summary

Constructors

Constructor and Description
Bean2XmlConverter(Bean2XmlOptions... options)

Method Summary

Methods

Modifier and Type	Method and Description
Element	convert(Object obj, String rootName) Creates an XML DOM with the specified root element name, and fills it by introspecting the passed object.
Element	convert(Object obj, String nsUri, String rootName) Creates an XML DOM with the specified root element name and namespace URI, and fills it by introspecting the passed object.
List<ConversionException>	getDeferredExceptions() If the deferred exceptions option has been set, returns the list of deferred exceptions.

Methods inherited from class java.lang.Object

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

Constructor Detail

Bean2XmlConverter

public Bean2XmlConverter(Bean2XmlOptions... options)

Method Detail

convert

public Element convert(Object obj,
              String rootName)

Creates an XML DOM with the specified root element name, and fills it by introspecting the passed object.

Neither elements nor attributes in the resulting DOM are namespaced.

convert

public Element convert(Object obj,
              String nsUri,
              String rootName)

Creates an XML DOM with the specified root element name and namespace URI, and fills it by introspecting the passed object.

All decendent elements will use the same namespace URI (and prefix, if provided) as the root. Attributes created by the converter use the "conversion" namespace, found in ConversionConstants.

getDeferredExceptions

public List<ConversionException> getDeferredExceptions()

If the deferred exceptions option has been set, returns the list of deferred exceptions. Returns an empty list if the option was not set, or if no exceptions were thrown.

The returned list is immutable.