com.massa.util.convert

Class ConvertUtils

java.lang.Object

com.massa.util.convert.ConvertUtils

public class ConvertUtils
extends Object

Utility class for conversions. The default instance might be accessed by the getDefaultInstance() method, but it might be overridden for specific purposes.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ConvertUtils()

Method Summary

Modifier and Type	Method and Description
<T> T	cast(Class<T> clazz, Object value) Casts an Object into the expected type.
Object	convert(Class<?> clazz, Object value) Converts an Object into the expected type, handling Arrays and Collections.
void	deregister(Class<?> type) Removes registered converter for this class.
static ConvertUtils	getDefaultInstance()
static boolean	isConvertible(Class<?> sourceType, Class<?> targetType) Tells if source can be cast to target
static boolean	isHandled(Class<?> type) Tells if this type is handled by a dedicated converter.
IConverter	lookup(Class<?> clazz) Searches for a Converter able to handle this class or interface.
IConverter	lookup(Class<?> sourceType, Class<?> targetType) Searches for a Converter able to handle conversions from sourceType to targetType.
void	registerConverter(IConverter converter) Convenience method to not override converter types.
void	registerConverter(IConverter converter, Class<?>... forTypes) Registers a new Converter instance.
void	registerDefaultConverters() Reloads registration of defaults converters.
String	toString(Object value) Safe shortcut to for the cast(Class, Object) with String as a target class, handling Exceptions by returning the native Object.toString() result.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConvertUtils

protected ConvertUtils()

Method Detail

getDefaultInstance

public static ConvertUtils getDefaultInstance()

Returns:

Default global instance.

registerDefaultConverters

public void registerDefaultConverters()

Reloads registration of defaults converters.

deregister

public void deregister(Class<?> type)

Removes registered converter for this class.

registerConverter

public void registerConverter(IConverter converter)

Convenience method to not override converter types.

registerConverter

public void registerConverter(IConverter converter,
                              Class<?>... forTypes)

Registers a new Converter instance. Overwrites previously conflicting converter if present.

Parameters:

converter - Converter to register

forTypes - If not null, ignores Converter types and uses these.

lookup

public IConverter lookup(Class<?> clazz)

Searches for a Converter able to handle this class or interface.

lookup

public IConverter lookup(Class<?> sourceType,
                         Class<?> targetType)

Searches for a Converter able to handle conversions from sourceType to targetType.

cast

public <T> T cast(Class<T> clazz,
                  Object value)
           throws UtilsException

Casts an Object into the expected type.

Parameters:

clazz - The target class

value - The value to cast

Throws:

UtilsException - If cast is impossible

See Also:

IConverter.convertToType(Class, Object)

convert

public Object convert(Class<?> clazz,
                      Object value)
               throws UtilsException

Converts an Object into the expected type, handling Arrays and Collections.

Parameters:

clazz - The target class

value - The value to convert

Throws:

UtilsException - If conversion is impossible

See Also:

IConverter.typeConversion(Class, Object)

toString

public String toString(Object value)

Safe shortcut to for the cast(Class, Object) with String as a target class, handling Exceptions by returning the native Object.toString() result.

isConvertible

public static boolean isConvertible(Class<?> sourceType,
                                    Class<?> targetType)

Tells if source can be cast to target

isHandled

public static boolean isHandled(Class<?> type)

Tells if this type is handled by a dedicated converter.