org.apache.tapestry5.internal.translator
Interface NumericTranslatorSupport

All Known Implementing Classes:

NumericTranslatorSupportImpl

public interface NumericTranslatorSupport

Used to generate the client-side JSON specification for how a number-based validator operates. Uses ThreadLocale to determine the locale for any locale-specific operations.

Since:

5.1.0.1

Method Summary

<T extends Number> void	addValidation(Class<T> type, Field field, String message) Adds client-side format validation for the field, appropriate to the indicated type.
<T extends Number> String	getMessageKey(Class<T> type) Returns the default message key for parse failures for the indicated type.
<T extends Number> T	parseClient(Class<T> type, String clientValue) Parses a client-submitted value in a localized manner.
<T extends Number> String	toClient(Class<T> type, T value) Converts a server-side value to a client-side string.

Method Detail

parseClient

<T extends Number> T parseClient(Class<T> type,
                                 String clientValue)
                             throws ParseException

Parses a client-submitted value in a localized manner.

Type Parameters:

T -

Parameters:

type - desired type of value

clientValue - value from client; this will be trimmed of leading/trailing whitespace

Returns:

the parsed value

Throws:

ParseException

See Also:

Translator.parseClient(org.apache.tapestry5.Field, String, String)

toClient

<T extends Number> String toClient(Class<T> type,
                                   T value)

Converts a server-side value to a client-side string. Integer types are formatted simply; decimal types may be formatted using thousands-seperator commas.

Type Parameters:

T -

Parameters:

type - type of value to convert

value - current (non-null) value

Returns:

value formatted

getMessageKey

<T extends Number> String getMessageKey(Class<T> type)

Returns the default message key for parse failures for the indicated type.

Type Parameters:

T -

Parameters:

type -

Returns:

a message key: either "integer-format-exception" or "number-format-exception"

addValidation

<T extends Number> void addValidation(Class<T> type,
                                      Field field,
                                      String message)

Adds client-side format validation for the field, appropriate to the indicated type.

Type Parameters:

T -

Parameters:

type - value type

field - field to which validation should be added

message - message if the client-side value can't be parsed as a number