com.thoughtworks.xstream.converters.basic
Class DateConverter

java.lang.Object
  extended by com.thoughtworks.xstream.converters.basic.AbstractSingleValueConverter
      extended by 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
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
 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


Copyright © 2004-2012 XStream. All Rights Reserved.