to.etc.domui.converter

Class ConverterRegistry

java.lang.Object

to.etc.domui.converter.ConverterRegistry

public class ConverterRegistry
extends Object

A repository of Converter instances.

Author:

Frits Jalvingh Created on Jun 12, 2008

Field Summary

Fields

Modifier and Type	Field and Description
static Comparator<Object>	DEFAULT_COMPARATOR

Constructor Summary

Constructors

Constructor and Description
ConverterRegistry()

Method Summary

Modifier and Type	Method and Description
static <X,T extends IConverter<X>> X	convertStringToValue(Class<T> clz, Locale loc, String in) Convert a String value to some object, using the specified converter.
static <X,T extends IConverter<X>> X	convertStringToValue(Class<T> clz, String in) Convert a String value to some object, using the specified converter.
static <X> String	convertToString(PropertyMetaModel<X> pmm, X value) Convert the value which is for a given property to a presentation string.
static <X> X	convertURLStringToValue(Class<X> toType, String svalue) Convert the URL string passed to some object value.
static <X,T extends IConverter<X>> String	convertValueToString(Class<T> clz, Locale loc, X in) Convert some object to a String value, using the specified converter.
static <X,T extends IConverter<X>> String	convertValueToString(Class<T> clz, X in) Convert some object to a String value, using the specified converter.
static <X> IConverter<X>	findBestConverter(PropertyMetaModel<X> pmm) Obtain the very best presentation converter we can find for the specified property.
static <X> IConverter<X>	findConverter(Class<X> clz) Finds the best converter to convert a value of the specified type to a string.
static <X> IConverter<X>	findConverter(Class<X> clz, PropertyMetaModel<X> pmm) Finds the best converter to convert a value of the specified type (and the optionally specified metadata) to a string.
static <X> IConverter<X>	findURLConverter(Class<X> totype) Find an URL converter to convert to the given type.
static <T> Comparator<T>	getComparator(Class<T> dataClass, String property, boolean descending)
static Comparator<?>	getComparator(ClassMetaModel cmm, String property, boolean descending)
static <X> IConverter<X>	getConverter(Class<X> clz, PropertyMetaModel<X> pmm) Gets the best converter to convert a value of the specified type (and the optionally specified metadata) to a string.
static <X,T extends IConverter<X>> T	getConverterInstance(Class<T> clz) Get an instance of a given converter type.
static void	register(IConverterFactory cf) Registers the specified converter factory.
static <T> void	registerComparator(Comparator<T> comp, Class<?>... valueClass) Register a comparator for a given type.
static <X> void	registerURLConverter(Class<X> totype, IConverter<X> c) Register an URL converter for the specified class.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_COMPARATOR

public static final Comparator<Object> DEFAULT_COMPARATOR

Constructor Detail

ConverterRegistry

public ConverterRegistry()

Method Detail

getConverterInstance

@Nonnull
public static <X,T extends IConverter<X>> T getConverterInstance(@Nonnull
                                                                          Class<T> clz)

Get an instance of a given converter type. Instances are cached and reused.

Parameters:

clz -

Returns:

convertStringToValue

public static <X,T extends IConverter<X>> X convertStringToValue(Class<T> clz,
                                                                 Locale loc,
                                                                 String in)
                                                          throws Exception

Convert a String value to some object, using the specified converter.

Parameters:

clz -

loc -

in -

Returns:

Throws:

Exception

convertValueToString

public static <X,T extends IConverter<X>> String convertValueToString(Class<T> clz,
                                                                      Locale loc,
                                                                      X in)
                                                               throws Exception

Convert some object to a String value, using the specified converter.

Parameters:

clz -

loc -

in -

Returns:

Throws:

Exception

convertStringToValue

public static <X,T extends IConverter<X>> X convertStringToValue(Class<T> clz,
                                                                 String in)
                                                          throws Exception

Convert a String value to some object, using the specified converter. This uses the "current" locale.

Parameters:

clz -

in -

Returns:

Throws:

Exception

convertValueToString

@Nonnull
public static <X,T extends IConverter<X>> String convertValueToString(Class<T> clz,
                                                                               X in)
                                                                        throws Exception

Convert some object to a String value, using the specified converter. This uses the "current" locale.

Parameters:

clz -

in -

Returns:

Throws:

Exception

registerURLConverter

public static <X> void registerURLConverter(Class<X> totype,
                                            IConverter<X> c)

Register an URL converter for the specified class.

Parameters:

totype -

c -

findURLConverter

public static <X> IConverter<X> findURLConverter(Class<X> totype)

Find an URL converter to convert to the given type.

Parameters:

totype -

Returns:

convertURLStringToValue

public static <X> X convertURLStringToValue(Class<X> toType,
                                            String svalue)
                                     throws Exception

Convert the URL string passed to some object value.

Parameters:

toType -

svalue -

Returns:

Throws:

Exception

register

public static void register(IConverterFactory cf)

Registers the specified converter factory.

findConverter

public static <X> IConverter<X> findConverter(Class<X> clz,
                                              PropertyMetaModel<X> pmm)

Finds the best converter to convert a value of the specified type (and the optionally specified metadata) to a string. This walks the converter factory list and finds the best converter to use. If no factory accepts the type this returns null. To get a valid converter all of the time use getConverter(); this returns the "default converter" if no specific converter could be found.

Parameters:

clz - The class type of the value to convert

pmm - The metadata for the property, or null if unknown.

Returns:

A converter instance, or null if no factory claimed the type.

findConverter

public static <X> IConverter<X> findConverter(Class<X> clz)

Finds the best converter to convert a value of the specified type to a string. This walks the converter factory list and finds the best converter to use. If no factory accepts the type this returns null. To get a valid converter all of the time use getConverter(); this returns the "default converter" if no specific converter could be found.

Parameters:

clz - The class type of the value to convert

getConverter

public static <X> IConverter<X> getConverter(Class<X> clz,
                                             PropertyMetaModel<X> pmm)

Gets the best converter to convert a value of the specified type (and the optionally specified metadata) to a string. This walks the converter factory list and finds the best converter to use. If no factory accepts the type this returns the default converter.

Parameters:

clz - The class type of the value to convert

pmm - The metadata for the property, or null if unknown.

Returns:

A converter instance.

convertToString

public static <X> String convertToString(PropertyMetaModel<X> pmm,
                                         X value)

Convert the value which is for a given property to a presentation string.

Type Parameters:

X -

Parameters:

pmm -

value -

Returns:

findBestConverter

public static <X> IConverter<X> findBestConverter(PropertyMetaModel<X> pmm)

Obtain the very best presentation converter we can find for the specified property.

Parameters:

pmm -

Returns:

registerComparator

public static <T> void registerComparator(@Nonnull
                                          Comparator<T> comp,
                                          Class<?>... valueClass)

Register a comparator for a given type.

Parameters:

valueClass -

comp -

getComparator

public static <T> Comparator<T> getComparator(@Nonnull
                                              Class<T> dataClass,
                                              @Nonnull
                                              String property,
                                              boolean descending)

Parameters:

dataClass -

property -

descending -

Returns:

getComparator

public static Comparator<?> getComparator(@Nonnull
                                          ClassMetaModel cmm,
                                          @Nonnull
                                          String property,
                                          boolean descending)