Package org.apache.tapestry5
Interface FieldTranslator<T>
- All Known Implementing Classes:
FieldTranslatorImpl
public interface FieldTranslator<T>
A wrapper around
Translator
that combines the translator for a specific Field
and (sometimes) an override of the default validation message (used when an input value
can't be parsed).-
Method Summary
Modifier and TypeMethodDescriptiongetType()
Returns the type of the server-side value.Invoked after the client-submitted value has beentranslated
to check that the value conforms to expectations (often, in terms of minimum or maximum value).void
render
(MarkupWriter writer) Converts a server-side value to a client-side string.
-
Method Details
-
getType
Returns the type of the server-side value.- Returns:
- a type
-
parse
Invoked after the client-submitted value has beentranslated
to check that the value conforms to expectations (often, in terms of minimum or maximum value). If and only if the value is approved by all Validators is the value applied by the field.- Throws:
ValidationException
- if the value violates the constraint
-
toClient
Converts a server-side value to a client-side string. This allows for formatting of the value in a way appropriate to the end user.- Parameters:
value
- the server side value (which will not be null)- Returns:
- client-side value to present to the user
- See Also:
-
render
InvokesTranslator.render(Field, String, MarkupWriter,org.apache.tapestry5.services.FormSupport)
. This is called at a point "inside" the tag, so that additional attributes may be added. In many cases, the underlyingValidator
may write client-side JavaScript to enforce the constraint as well.- Parameters:
writer
- markup writer to direct output to.- See Also:
-