org.databene.commons.converter
Class ToStringConverter

java.lang.Object
  org.databene.commons.converter.FormatHolder
      org.databene.commons.converter.ToStringConverter

All Implemented Interfaces:

java.lang.Cloneable, Converter<java.lang.Object,java.lang.String>, Patterns, ThreadAware

public class ToStringConverter
extends FormatHolder
implements Converter<java.lang.Object,java.lang.String>, java.lang.Cloneable

Converts an object to a String by using its toString() method. Null values can be mapped to an individual String.

Created: 31.08.2006 18:44:59

Since:

0.1

Author:

Volker Bergmann

Field Summary

Fields inherited from class org.databene.commons.converter.FormatHolder

charQuote, datePattern, dateTimePattern, decimalConverter, integralConverter, nullString, stringQuote, timePattern, timestampPattern

Fields inherited from interface org.databene.commons.Patterns

DEFAULT_DATE_PATTERN, DEFAULT_DATETIME_MICROS_PATTERN, DEFAULT_DATETIME_MILLIS_PATTERN, DEFAULT_DATETIME_MINUTES_PATTERN, DEFAULT_DATETIME_NANOS_PATTERN, DEFAULT_DATETIME_PATTERN, DEFAULT_DATETIME_SECONDS_PATTERN, DEFAULT_NULL_STRING, DEFAULT_TIME_MILLIS_PATTERN, DEFAULT_TIME_MINUTES_PATTERN, DEFAULT_TIME_PATTERN, DEFAULT_TIME_SECONDS_PATTERN, DEFAULT_TIMESTAMP_PATTERN

Constructor Summary

ToStringConverter()
Default constructor that uses an isEmpty String as null representation

ToStringConverter(java.lang.String nullString)
Constructor that initializes the null replacement to the specified parameter.

ToStringConverter(java.lang.String nullString, java.lang.String datePattern, java.lang.String timestampPattern)

Method Summary

boolean	canConvert(java.lang.Object sourceValue)
java.lang.String	convert(java.lang.Object source) Concerts an object of type S to an object of type T
static <TT> java.lang.String	convert(TT source, java.lang.String nullString)
java.lang.Class<java.lang.Object>	getSourceType()
java.lang.Class<java.lang.String>	getTargetType()
boolean	isParallelizable()
boolean	isThreadSafe()

Methods inherited from class org.databene.commons.converter.FormatHolder

clone, getCharQuote, getDatePattern, getDateTimePattern, getDecimalPattern, getDecimalSeparator, getIntegralPattern, getNullString, getStringQuote, getTimePattern, getTimestampPattern, setCharQuote, setDatePattern, setDateTimePattern, setDecimalPattern, setDecimalSeparator, setIntegralPattern, setNullString, setStringQuote, setTimePattern, setTimestampPattern

Methods inherited from class java.lang.Object

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

Constructor Detail

ToStringConverter

public ToStringConverter()

Default constructor that uses an isEmpty String as null representation

ToStringConverter

public ToStringConverter(java.lang.String nullString)

Constructor that initializes the null replacement to the specified parameter.

Parameters:

nullString - the String to use for replacing null values.

ToStringConverter

public ToStringConverter(java.lang.String nullString,
                         java.lang.String datePattern,
                         java.lang.String timestampPattern)

Method Detail

canConvert

public boolean canConvert(java.lang.Object sourceValue)

getSourceType

public java.lang.Class<java.lang.Object> getSourceType()

Specified by:

getSourceType in interface Converter<java.lang.Object,java.lang.String>

getTargetType

public java.lang.Class<java.lang.String> getTargetType()

Specified by:

getTargetType in interface Converter<java.lang.Object,java.lang.String>

convert

public java.lang.String convert(java.lang.Object source)
                         throws ConversionException

Description copied from interface: Converter

Concerts an object of type S to an object of type T

Specified by:

convert in interface Converter<java.lang.Object,java.lang.String>

Parameters:

source - the object to convert

Returns:

the converted object

Throws:

ConversionException - if the conversion fails

isThreadSafe

public boolean isThreadSafe()

Specified by:

isThreadSafe in interface ThreadAware

isParallelizable

public boolean isParallelizable()

Specified by:

isParallelizable in interface ThreadAware

convert

public static <TT> java.lang.String convert(TT source,
                                            java.lang.String nullString)