org.granite.messaging.amf.io.convert

Class Converters

java.lang.Object

org.granite.messaging.amf.io.convert.Converters

public class Converters
extends java.lang.Object

Author:

Franck WOLFF

See Also:

Converter, Reverter

Constructor Summary

Constructors

Constructor and Description
Converters(java.util.List<java.lang.Class<? extends Converter>> converterClasses) Constructs a new Converters instance with the supplied list of converters (possibly reverters).

Method Summary

Methods

Modifier and Type	Method and Description
void	addConverter(java.lang.Class<? extends Converter> converterClass)
java.lang.Object	convert(java.lang.Object value, java.lang.reflect.Type targetType) Converts the supplied object to the supplied target type.
Converter	getConverter(java.lang.Object value, java.lang.reflect.Type targetType) Returns a suitable converter for supplied parameters or null if no converter can be found.
Converter	getConverter(java.lang.Object value, java.lang.reflect.Type targetType, boolean throwNotFoundException) Returns a suitable converter for supplied parameters or either returns null if no converter can be found or throws a NoConverterFoundException.
Converter[]	getConverters()
boolean	hasReverters() Returns true if at least one reverter is configured for this Converters instance.
java.lang.Object	revert(java.lang.Object value) Revert back to standard (AMF3 known Java type) the supplied value.

Methods inherited from class java.lang.Object

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

Constructor Detail

Converters

public Converters(java.util.List<java.lang.Class<? extends Converter>> converterClasses)
           throws java.lang.NoSuchMethodException,
                  java.lang.IllegalAccessException,
                  java.lang.reflect.InvocationTargetException,
                  java.lang.InstantiationException

Constructs a new Converters instance with the supplied list of converters (possibly reverters).

Parameters:

converterClasses - the list of all used converters.

Throws:

java.lang.NoSuchMethodException - if one of the Converter does not have a constructor with a Converters parameter.

java.lang.IllegalAccessException - if something goes wrong when creating an instance of one of the supplied Converter classes.

java.lang.reflect.InvocationTargetException - if something goes wrong when creating an instance of one of the supplied Converter classes.

java.lang.InstantiationException - if something goes wrong when creating an instance of one of the supplied Converter classes.

Method Detail

addConverter

public void addConverter(java.lang.Class<? extends Converter> converterClass)
                  throws java.lang.NoSuchMethodException,
                         java.lang.IllegalAccessException,
                         java.lang.reflect.InvocationTargetException,
                         java.lang.InstantiationException

Throws:

java.lang.NoSuchMethodException

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

java.lang.InstantiationException

getConverter

public Converter getConverter(java.lang.Object value,
                     java.lang.reflect.Type targetType)

Returns a suitable converter for supplied parameters or null if no converter can be found. This method is equivalent to the getConverter(Object, Type, boolean) method with the throwNotFoundException parameter set to false.

Parameters:

value - the value to be converted

targetType - the type of the converted value

Returns:

a Converter instance or null if no suitable converter can be found

getConverter

public Converter getConverter(java.lang.Object value,
                     java.lang.reflect.Type targetType,
                     boolean throwNotFoundException)
                       throws NoConverterFoundException

Returns a suitable converter for supplied parameters or either returns null if no converter can be found or throws a NoConverterFoundException.

Parameters:

value - the value to be converted

targetType - the type of the converted value

throwNotFoundException - should an exception be thrown if no converter is found?

Returns:

a Converter instance or null if no suitable converter can be found

Throws:

NoConverterFoundException - if the throwNotFoundException parameter is set to true and no converter can be found.

convert

public java.lang.Object convert(java.lang.Object value,
                       java.lang.reflect.Type targetType)
                         throws NoConverterFoundException

Converts the supplied object to the supplied target type. This method is a simple shortcut for: this.getConverter(value, target, true).convert(value, targetType).

Parameters:

value - the object to be converted.

targetType - the target type.

Returns:

the converted object.

Throws:

NoConverterFoundException - if no suitable converter can be found.

hasReverters

public boolean hasReverters()

Returns true if at least one reverter is configured for this Converters instance.

Returns:

true if at least one reverter is configured for this Converters instance.

revert

public java.lang.Object revert(java.lang.Object value)

Revert back to standard (AMF3 known Java type) the supplied value. This method iterates on all configured Reverters and returns the Reverter.revert(Object) method result if the Reverter.canRevert(Object) method returns true for the current Reverter instance.

Parameters:

value - the value to be reverted.

Returns:

the reverted value (same instance if none of the configured reverters apply).

getConverters

public Converter[] getConverters()