biz.hammurapi.convert
Class CompositeConverter

java.lang.Object
  biz.hammurapi.convert.CompositeConverter

public class CompositeConverter
extends java.lang.Object

Version:

$Revision: 1.7 $

Author:

Pavel Vlasov

Constructor Summary

CompositeConverter()
Creates new composite converter populated by default with some generic converters.

Method Summary

void	addConverter(java.lang.Class source, java.lang.Class target, Converter converter) Adds a converter from source object to target class.
Converter	addConverter(java.lang.Class source, java.lang.Class target, java.lang.String accessor, java.lang.reflect.Constructor constructor) Adds a converter which uses method of source object and constructor of target object to perform conversion.
java.lang.Object	convert(java.lang.Object source, java.lang.Class target, boolean lenient) Converts source object to target class instance
static CompositeConverter	getDefaultConverter()
boolean	isImmutable()
void	setImmutable() Makes converter immutable.

Methods inherited from class java.lang.Object

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

Constructor Detail

CompositeConverter

public CompositeConverter()

Creates new composite converter populated by default with some generic converters.

Method Detail

isImmutable

public boolean isImmutable()

Returns:

true if no additional converters can be added to this converter.

setImmutable

public void setImmutable()

Makes converter immutable.

getDefaultConverter

public static CompositeConverter getDefaultConverter()

addConverter

public Converter addConverter(java.lang.Class source,
                              java.lang.Class target,
                              java.lang.String accessor,
                              java.lang.reflect.Constructor constructor)

Adds a converter which uses method of source object and constructor of target object to perform conversion.

Parameters:

source - Source object.

target - Target class.

accessor - Method name to invoke on source to obtain intermediate object. Can be null.

constructor - Target constructor. Can be null.

addConverter

public void addConverter(java.lang.Class source,
                         java.lang.Class target,
                         Converter converter)

Adds a converter from source object to target class.

Parameters:

source -

target -

converter -

convert

public java.lang.Object convert(java.lang.Object source,
                                java.lang.Class target,
                                boolean lenient)

Converts source object to target class instance

Parameters:

source - Source object

target - Target class. If target class is String then toString() is always used.

lenient - When true null is returned if conversion cannot be performed, otherwise ConversionException is thrown

Returns:

Instance of target class.

Throws:

ConversionException - If lenient=false and conversion cannot be performed.