org.directwebremoting.convert
Class XmlBeanConverter

java.lang.Object
  org.directwebremoting.convert.BaseV20Converter
      org.directwebremoting.convert.BasicObjectConverter
          org.directwebremoting.convert.BeanConverter
              org.directwebremoting.convert.XmlBeanConverter

All Implemented Interfaces:

Converter, NamedConverter

public class XmlBeanConverter
extends BeanConverter

A Converter for Apache XMLBeans.

Author:

Joe Walker [joe at getahead dot ltd dot uk], Matthew Young [matthew dot young at forsakringskassan dot se]

Constructor Summary

XmlBeanConverter()

Method Summary

java.lang.Object	convertInbound(java.lang.Class<?> paramType, InboundVariable iv, InboundContext inctx) Attempt to coerce the data from a string to an Object.
java.util.Map<java.lang.String,Property>	getPropertyMapFromClass(java.lang.Class<?> paramType, boolean readRequired, boolean writeRequired) Get a map of property names to implementations of Property.

Methods inherited from class org.directwebremoting.convert.BeanConverter

getPropertyMapFromObject

Methods inherited from class org.directwebremoting.convert.BasicObjectConverter

convertOutbound, getConverterManager, getInstanceType, getJavascript, setConverterManager, setExclude, setImplementation, setInclude, setInstanceType, setJavascript

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.directwebremoting.extend.Converter

convertOutbound, setConverterManager

Constructor Detail

XmlBeanConverter

public XmlBeanConverter()

Method Detail

convertInbound

public java.lang.Object convertInbound(java.lang.Class<?> paramType,
                                       InboundVariable iv,
                                       InboundContext inctx)
                                throws MarshallException

Description copied from interface: Converter

Attempt to coerce the data from a string to an Object. If anything goes wrong with inbound conversion then we generally throw an exception because we are converting data from the untrusted Internet so we take the assumption that anything wrong is someone hacking.

Specified by:

convertInbound in interface Converter

Overrides:

convertInbound in class BasicObjectConverter

Parameters:

paramType - The type to convert to

iv - The data to convert

inctx - The map of data that we are working on

Returns:

The converted data, or null if the conversion was not possible

Throws:

MarshallException - If the conversion failed for some reason

getPropertyMapFromClass

public java.util.Map<java.lang.String,Property> getPropertyMapFromClass(java.lang.Class<?> paramType,
                                                                        boolean readRequired,
                                                                        boolean writeRequired)
                                                                 throws MarshallException

Description copied from interface: NamedConverter

Get a map of property names to implementations of Property.

HibernateBeanConverter (and maybe others) may want to provide alternate versions of bean.getClass(), and we may wish to fake or hide properties in some cases.

If you have a real object to investigate then it is probably better to call NamedConverter.getPropertyMapFromObject(Object, boolean, boolean) because that version can take into accound extra runtime type info.

Specified by:

getPropertyMapFromClass in interface NamedConverter

Overrides:

getPropertyMapFromClass in class BeanConverter

Parameters:

paramType - The class to find bean info from

readRequired - The properties returned must be readable

writeRequired - The properties returned must be writeable

Returns:

An array of PropertyDescriptors describing the beans properties

Throws:

MarshallException - If the introspection fails

See Also:

NamedConverter.getPropertyMapFromObject(Object, boolean, boolean)