com.vaadin.data.util.converter

Class StringToDateConverter

java.lang.Object

com.vaadin.data.util.converter.StringToDateConverter

All Implemented Interfaces:

Converter<String,Date>, Serializable

public class StringToDateConverter
extends Object
implements Converter<String,Date>

A converter that converts from Date to String and back. Uses the given locale and DateFormat for formatting and parsing.

Leading and trailing white spaces are ignored when converting from a String.

Override and overwrite getFormat(Locale) to use a different format.

Since:

7.0

Author:

Vaadin Ltd

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.vaadin.data.util.converter.Converter

Converter.ConversionException

Constructor Summary

Constructors

Constructor and Description
StringToDateConverter()

Method Summary

Modifier and Type	Method and Description
Date	convertToModel(String value, Class<? extends Date> targetType, Locale locale) Converts the given value from target type to source type.
String	convertToPresentation(Date value, Class<? extends String> targetType, Locale locale) Converts the given value from source type to target type.
protected DateFormat	getFormat(Locale locale) Returns the format used by convertToPresentation(Date, Class,Locale) and convertToModel(String, Class, Locale).
Class<Date>	getModelType() The source type of the converter.
Class<String>	getPresentationType() The target type of the converter.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringToDateConverter

public StringToDateConverter()

Method Detail

getFormat

protected DateFormat getFormat(Locale locale)

Returns the format used by convertToPresentation(Date, Class,Locale) and convertToModel(String, Class, Locale).

Parameters:

locale - The locale to use

Returns:

A DateFormat instance

convertToModel

public Date convertToModel(String value,
                           Class<? extends Date> targetType,
                           Locale locale)
                    throws Converter.ConversionException

Description copied from interface: Converter

Converts the given value from target type to source type.

A converter can optionally use locale to do the conversion.

A converter should in most cases be symmetric so chaining Converter.convertToPresentation(Object, Class, Locale) and Converter.convertToModel(Object, Class, Locale) should return the original value.

Specified by:

convertToModel in interface Converter<String,Date>

Parameters:

value - The value to convert, compatible with the target type. Can be null

targetType - The requested type of the return value

locale - The locale to use for conversion. Can be null.

Returns:

The converted value compatible with the source type

Throws:

Converter.ConversionException - If the value could not be converted

convertToPresentation

public String convertToPresentation(Date value,
                                    Class<? extends String> targetType,
                                    Locale locale)
                             throws Converter.ConversionException

Description copied from interface: Converter

Converts the given value from source type to target type.

A converter can optionally use locale to do the conversion.

A converter should in most cases be symmetric so chaining Converter.convertToPresentation(Object, Class, Locale) and Converter.convertToModel(Object, Class, Locale) should return the original value.

Specified by:

convertToPresentation in interface Converter<String,Date>

Parameters:

value - The value to convert, compatible with the target type. Can be null

targetType - The requested type of the return value

locale - The locale to use for conversion. Can be null.

Returns:

The converted value compatible with the source type

Throws:

Converter.ConversionException - If the value could not be converted

getModelType

public Class<Date> getModelType()

Description copied from interface: Converter

The source type of the converter. Values of this type can be passed to Converter.convertToPresentation(Object, Class, Locale).

Specified by:

getModelType in interface Converter<String,Date>

Returns:

The source type

getPresentationType

public Class<String> getPresentationType()

Description copied from interface: Converter

The target type of the converter. Values of this type can be passed to Converter.convertToModel(Object, Class, Locale).

Specified by:

getPresentationType in interface Converter<String,Date>

Returns:

The target type