org.srplib.conversion

Class Converters

java.lang.Object

org.srplib.conversion.Converters

public class Converters
extends java.lang.Object

Factory class producing instances of Converter and ConverterRegistry

Constructor Summary

Constructors

Constructor and Description
Converters()

Method Summary

Modifier and Type	Method and Description
static <I,O> org.srplib.conversion.Converter<I,O>	chain(org.srplib.conversion.Converter... converters) Converts vararg array of converters into single converter.
static <I,O> org.srplib.conversion.Converter<I,O>	chain(java.util.List<org.srplib.conversion.Converter> converters) Converts list of converters into single converter.
static <I,O> org.srplib.conversion.Converter<I,O>	choice(java.util.Map<I,O> map) Creates converter which uses map for value conversion.
static <I,O> org.srplib.conversion.Converter<I,O>	choice(java.util.Map<I,O> map, O defaultValue) Creates converter which uses map for value conversion.
static <T> org.srplib.conversion.Converter<java.lang.Boolean,T>	choice(T trueValue, T falseValue) Creates converter from boolean value to specified alternatives.
static <I,O> org.srplib.conversion.TwoWayConverter<I,O>	empty() Returns EmptyConverter which simply returns passed value back.
static <T> org.srplib.conversion.Converter<T,java.lang.Boolean>	equal(T object) Creates converter from object to boolean.
static org.srplib.conversion.ConverterRegistry	newDefaultRegistry() Returns default converter registry containing basic converter set.
static org.srplib.conversion.ConverterRegistry	newRegistry() Returns empty converter registry.
static <T extends java.lang.Enum> org.srplib.conversion.Converter<java.lang.String,T>	newStringToEnumConverter(java.lang.Class<T> enumClass) Returns string to enum converter.

Methods inherited from class java.lang.Object

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

Constructor Detail

Converters

public Converters()

Method Detail

newRegistry

public static org.srplib.conversion.ConverterRegistry newRegistry()

Returns empty converter registry.

Returns:

ConverterRegistry converter registry without any converters.

newDefaultRegistry

public static org.srplib.conversion.ConverterRegistry newDefaultRegistry()

Returns default converter registry containing basic converter set.

Returns:

ConverterRegistry converter registry.

empty

public static <I,O> org.srplib.conversion.TwoWayConverter<I,O> empty()

Returns EmptyConverter which simply returns passed value back.

Returns:

EmptyConverter an empty converter

See Also:

EmptyConverter

newStringToEnumConverter

public static <T extends java.lang.Enum> org.srplib.conversion.Converter<java.lang.String,T> newStringToEnumConverter(java.lang.Class<T> enumClass)

Returns string to enum converter.

Call to this method is equivalent to new StringToEnumConverter(Sex.class)

Parameters:

enumClass - Class class of enum

Returns:

DataConverter

choice

public static <T> org.srplib.conversion.Converter<java.lang.Boolean,T> choice(T trueValue,
                                                                              T falseValue)

Creates converter from boolean value to specified alternatives.

Converter may be considered as IF (input) THEN trueValue ELSE falseValue

Parameters:

trueValue - a value to return if input value is true

falseValue - a value to return if input value is false

Returns:

Converter

choice

public static <I,O> org.srplib.conversion.Converter<I,O> choice(java.util.Map<I,O> map,
                                                                O defaultValue)

Creates converter which uses map for value conversion.

Converter may be considered as SWITCH (input) OF ... DEFAULT

Parameters:

map - Map a map where input values are keys and values are output values.

defaultValue - Object default value if no matches found in map

Returns:

Converter

See Also:

SwitchConverter

choice

public static <I,O> org.srplib.conversion.Converter<I,O> choice(java.util.Map<I,O> map)

Creates converter which uses map for value conversion.

Unlike choice(Map, Object) this method doesn't accept default value and throws IllegalStateException if no mapping is found.

Parameters:

map - Map a map where input values are keys and values are output values.

Returns:

Converter

See Also:

SwitchConverter

chain

public static <I,O> org.srplib.conversion.Converter<I,O> chain(org.srplib.conversion.Converter... converters)

Converts vararg array of converters into single converter.

Method is useful when you have serveral converters but API expect single instance. So you can make a chain of converters.

If converters is null or empty then empty() converter is returned (null-value)

If converters.length == 1 then converters[0] is returned

If converters.length > 1 then ChainConverter is returned.

Parameters:

converters - vararg of Converter

Returns:

Converter a converter encapsulating all converters.

chain

public static <I,O> org.srplib.conversion.Converter<I,O> chain(java.util.List<org.srplib.conversion.Converter> converters)

Converts list of converters into single converter.

Method is similar to chain(Converter[]).

Parameters:

converters - vararg of Converter

Returns:

Converter a converter encapsulating all converters.

equal

public static <T> org.srplib.conversion.Converter<T,java.lang.Boolean> equal(T object)

Creates converter from object to boolean.

Converter will return true if object is equal to specified object.

Parameters:

object - an object to compare to. Nulls are accepted.

Returns:

Converter from object to boolean.