Package com.norconex.commons.lang.convert

Class Converter

java.lang.Object

com.norconex.commons.lang.convert.Converter

All Implemented Interfaces:

IConverter

public final class Converter
extends Object
implements IConverter

Converts strings to objects and objects to strings. Supported object types are guaranteed to be convertibles both ways if converted by this class.

Can only be initialized at construction time or the default instance can be obtained statically.

Converted string values are NOT locale-specific. This class favors consistency over format and string values are not always appropriate for human-consumption.

Default instance has converters for the following types:

• Byte/byte
• Short/short
• Integer/int
• Float/float
• Long/long
• Double/double
• BigInteger
• BigDecimal
• Boolean/boolean
• Character/char
• File
• Path
• Date
• LocalDateTime
• ZonedDateTime
• Instant
• Locale
• Enum
• Dimension
• Duration
• ContentType
• Charset
• URL

By default ConverterException is thrown when conversion fails.

Since:

2.0.0

Author:

Pascal Essiembre

See Also:

ConverterException

Constructor Summary

Constructors

Constructor	Description
Converter(Map<Class<?>,IConverter> converters)

Method Summary

Modifier and Type	Method	Description
static String	convert(Object object)
static String	convert(Object object, String defaultValue)
static <T> T	convert(String value, Class<T> type)
static <T> T	convert(String value, Class<T> type, T defaultValue)
static List<String>	convert(List<Object> objects)
static <T> List<T>	convert(List<String> values, Class<T> type)
static Converter	defaultInstance()
IConverter	getConverter(Class<?> type)
Map<Class<?>,IConverter>	getConverters()
boolean	isConvertible(Class<?> type)
String	toString(Object object)
String	toString(Object object, String defaultValue)
List<String>	toString(List<?> objects)
<T> T	toType(String value, Class<T> type)
<T> T	toType(String value, Class<T> type, T defaultValue)
<T> List<T>	toType(List<String> values, Class<T> type)

Methods inherited from class java.lang.Object

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

Constructor Detail

Converter

public Converter(Map<Class<?>,IConverter> converters)

Method Detail

defaultInstance

public static Converter defaultInstance()

getConverters

public Map<Class<?>,IConverter> getConverters()

convert

public static <T> List<T> convert(List<String> values,
                                  Class<T> type)

convert

public static <T> T convert(String value,
                            Class<T> type)

convert

public static <T> T convert(String value,
                            Class<T> type,
                            T defaultValue)

convert

public static List<String> convert(List<Object> objects)

convert

public static String convert(Object object)

convert

public static String convert(Object object,
                             String defaultValue)

toType

public <T> List<T> toType(List<String> values,
                          Class<T> type)

toType

public <T> T toType(String value,
                    Class<T> type)

Specified by:

toType in interface IConverter

toType

public <T> T toType(String value,
                    Class<T> type,
                    T defaultValue)

Specified by:

toType in interface IConverter

toString

public List<String> toString(List<?> objects)

toString

public String toString(Object object)

Specified by:

toString in interface IConverter

toString

public String toString(Object object,
                       String defaultValue)

Specified by:

toString in interface IConverter

isConvertible

public boolean isConvertible(Class<?> type)

getConverter

public IConverter getConverter(Class<?> type)