biz.hammurapi.convert
Class CompositeConverter

java.lang.Object
  extended by 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.


Copyright © 2003 Hammurapi Group. All Rights Reserved.