com.vaadin.ui.declarative.converters
Class DesignToStringConverter<TYPE>

java.lang.Object
  com.vaadin.ui.declarative.converters.DesignToStringConverter<TYPE>

Type Parameters:

TYPE - Type of the data being converted.

All Implemented Interfaces:

Converter<java.lang.String,TYPE>, java.io.Serializable

public class DesignToStringConverter<TYPE>
extends java.lang.Object
implements Converter<java.lang.String,TYPE>

Utility class for DesignAttributeHandler that deals with converting various types to string.

Since:

7.4

Author:

Vaadin Ltd

See Also:

Serialized Form

Nested Class Summary

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

Converter.ConversionException

Field Summary

static java.lang.String

NULL_VALUE_REPRESENTATION A string that corresponds to how a null value is stored.

Constructor Summary

DesignToStringConverter(java.lang.Class<? extends TYPE> type)
Constructs the converter for a given type.

DesignToStringConverter(java.lang.Class<? extends TYPE> type, java.lang.String staticMethodName)
Constructs the converter for a given type, giving the name of the public static method that does the conversion from String.

Method Summary

TYPE	convertToModel(java.lang.String value, java.lang.Class<? extends TYPE> targetType, java.util.Locale locale) Converts the given value from target type to source type.
java.lang.String	convertToPresentation(TYPE value, java.lang.Class<? extends java.lang.String> targetType, java.util.Locale locale) Converts the given value from source type to target type.
java.lang.Class<TYPE>	getModelType() The source type of the converter.
java.lang.Class<java.lang.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

Field Detail

NULL_VALUE_REPRESENTATION

public static final java.lang.String NULL_VALUE_REPRESENTATION

A string that corresponds to how a null value is stored.

See Also:

Constant Field Values

Constructor Detail

DesignToStringConverter

public DesignToStringConverter(java.lang.Class<? extends TYPE> type)

Constructs the converter for a given type. Implicitly requires that a static method valueOf(String) is present in the type to do the conversion.

Parameters:

type - Type of values to convert.

DesignToStringConverter

public DesignToStringConverter(java.lang.Class<? extends TYPE> type,
                               java.lang.String staticMethodName)

Constructs the converter for a given type, giving the name of the public static method that does the conversion from String.

Parameters:

type - Type to convert.

staticMethodName - Method to call when converting from String to this type. This must be public and static method that returns an object of passed type.

Method Detail

convertToModel

public TYPE convertToModel(java.lang.String value,
                           java.lang.Class<? extends TYPE> targetType,
                           java.util.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<java.lang.String,TYPE>

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 java.lang.String convertToPresentation(TYPE value,
                                              java.lang.Class<? extends java.lang.String> targetType,
                                              java.util.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<java.lang.String,TYPE>

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 java.lang.Class<TYPE> 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<java.lang.String,TYPE>

Returns:

The source type

getPresentationType

public java.lang.Class<java.lang.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<java.lang.String,TYPE>

Returns:

The target type