com.thoughtworks.xstream.converters.basic

Class DateConverter

java.lang.Object

com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter

com.thoughtworks.xstream.converters.basic.DateConverter

All Implemented Interfaces:

ConverterMatcher, SingleValueConverter

public class DateConverter
extends AbstractSingleValueConverter

Converts a java.util.Date to a String as a date format, retaining precision down to milliseconds.

Author:

Joe Walnes, Jörg Schaible

Constructor Summary

Constructors

Constructor and Description
DateConverter() Construct a DateConverter with standard formats and lenient set off.
DateConverter(boolean lenient) Construct a DateConverter with standard formats.
DateConverter(java.lang.String defaultFormat, java.lang.String[] acceptableFormats) Construct a DateConverter with lenient set off.
DateConverter(java.lang.String defaultFormat, java.lang.String[] acceptableFormats, boolean lenient) Construct a DateConverter.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canConvert(java.lang.Class type) Determines whether the converter can marshall a particular type.
java.lang.Object	fromString(java.lang.String str) Unmarshals an Object from its single value representation.
java.lang.String	toString(java.lang.Object obj) Marshals an Object into a single value representation.

Methods inherited from class java.lang.Object

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

Constructor Detail

DateConverter

public DateConverter()

Construct a DateConverter with standard formats and lenient set off.

DateConverter

public DateConverter(boolean lenient)

Construct a DateConverter with standard formats.

Parameters:

lenient - the lenient setting of DateFormat.setLenient(boolean)

Since:

1.3

DateConverter

public DateConverter(java.lang.String defaultFormat,
             java.lang.String[] acceptableFormats)

Construct a DateConverter with lenient set off.

Parameters:

defaultFormat - the default format

acceptableFormats - fallback formats

DateConverter

public DateConverter(java.lang.String defaultFormat,
             java.lang.String[] acceptableFormats,
             boolean lenient)

Construct a DateConverter.

Parameters:

defaultFormat - the default format

acceptableFormats - fallback formats

lenient - the lenient setting of DateFormat.setLenient(boolean)

Since:

1.3

Method Detail

canConvert

public boolean canConvert(java.lang.Class type)

Description copied from interface: ConverterMatcher

Determines whether the converter can marshall a particular type.

Specified by:

canConvert in interface ConverterMatcher

Specified by:

canConvert in class AbstractSingleValueConverter

Parameters:

type - the Class representing the object type to be converted

fromString

public java.lang.Object fromString(java.lang.String str)

Description copied from interface: SingleValueConverter

Unmarshals an Object from its single value representation.

Specified by:

fromString in interface SingleValueConverter

Specified by:

fromString in class AbstractSingleValueConverter

Parameters:

str - the String with the single value of the Object

Returns:

the Object

toString

public java.lang.String toString(java.lang.Object obj)

Description copied from interface: SingleValueConverter

Marshals an Object into a single value representation.

Specified by:

toString in interface SingleValueConverter

Overrides:

toString in class AbstractSingleValueConverter

Parameters:

obj - the Object to be converted

Returns:

a String with the single value of the Object or null