Package 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

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `<T extends java.lang.Number> java.lang.String` | `getMessageKey​(java.lang.Class<T> type)` | Returns the default message key for parse failures for the indicated type.
    `<T extends java.lang.Number> T` | `parseClient​(java.lang.Class<T> type, java.lang.String clientValue)` | Parses a client-submitted value in a localized manner.
    `<T extends java.lang.Number> void` | `setupTranslation​(java.lang.Class<T> type, Element element, java.lang.String message)` | Adds client-side format validation for the field, appropriate to the indicated type.
    `<T extends java.lang.Number> java.lang.String` | `toClient​(java.lang.Class<T> type, T value)` | Converts a server-side value to a client-side string.

- - ### Method Detail

    - #### parseClient

          <T extends java.lang.Number> T parseClient​(java.lang.Class<T> type,
                                                     java.lang.String clientValue)
                                              throws java.text.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:
        `java.text.ParseException`
      See Also:
        `Translator.parseClient(org.apache.tapestry5.Field, String, String)`

    - #### toClient

          <T extends java.lang.Number> java.lang.String toClient​(java.lang.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 java.lang.Number> java.lang.String getMessageKey​(java.lang.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"

    - #### setupTranslation

          <T extends java.lang.Number> void setupTranslation​(java.lang.Class<T> type,
                                                             Element element,
                                                             java.lang.String message)

      Adds client-side format validation for the field, appropriate to the indicated type.
      Parameters:
        `type` - value type
        `element` -
        `message` - message if the client-side value can't be parsed as a number