net.sf.practicalxml.converter.bean

Class Xml2BeanConverter

java.lang.Object

net.sf.practicalxml.converter.bean.Xml2BeanConverter

public class Xml2BeanConverter
extends Object

Driver class for converting an XML DOM into a Java bean. 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.

Since:

1.1

Constructor Summary

Constructors

Constructor and Description
Xml2BeanConverter(Xml2BeanOptions... options)

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	convert(Element elem, Class<T> klass) Attempts to convert the passed DOM subtree into an object of the specified class.
Object	convertWithoutCast(Element elem, Class<?> klass) Attempts to convert the passed DOM subtree into an object of the specified class.
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

Xml2BeanConverter

public Xml2BeanConverter(Xml2BeanOptions... options)

Method Detail

convert

public <T> T convert(Element elem,
            Class<T> klass)

Attempts to convert the passed DOM subtree into an object of the specified class.

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.

convertWithoutCast

public Object convertWithoutCast(Element elem,
                        Class<?> klass)

Attempts to convert the passed DOM subtree into an object of the specified class. Note that this version does not use generics, and does not try to cast the result, whereas the public version does. Internally, we want to treat Integer.TYPE the same as Integer.class, and the cast prevents that.