org.apache.tapestry5.services

Interface FieldTranslatorSource

All Known Implementing Classes:

FieldTranslatorSourceImpl

public interface FieldTranslatorSource

For a particular field, generates the default FieldTranslator for the field.

Method Summary

Modifier and Type	Method and Description
FieldTranslator	createDefaultTranslator(ComponentResources resources, String parameterName) Common shorthand for createDefaultTranslator(org.apache.tapestry5.Field, String, org.apache.tapestry5.ioc.Messages, java.util.Locale, Class, org.apache.tapestry5.ioc.AnnotationProvider).
FieldTranslator	createDefaultTranslator(Field field, String overrideId, Messages overrideMessages, Locale locale, Class propertyType, AnnotationProvider propertyAnnotations) Creates a FieldTranslator for the given property, or returns null if one can't be constructed.
FieldTranslator	createTranslator(ComponentResources componentResources, String translatorName) Creates a translator (used by the translate: binding prefix).
FieldTranslator	createTranslator(Field field, String overrideId, Messages overrideMessages, Locale locale, Translator translator) Wraps a Translator as a FieldTranslator.

Method Detail

createDefaultTranslator

FieldTranslator createDefaultTranslator(ComponentResources resources,
                                        String parameterName)

Common shorthand for createDefaultTranslator(org.apache.tapestry5.Field, String, org.apache.tapestry5.ioc.Messages, java.util.Locale, Class, org.apache.tapestry5.ioc.AnnotationProvider).

Parameters:

resources - of component who owns the parameter

parameterName - name of parameter used to determine the property type

Returns:

field translator, or null

createDefaultTranslator

FieldTranslator createDefaultTranslator(Field field,
                                        String overrideId,
                                        Messages overrideMessages,
                                        Locale locale,
                                        Class propertyType,
                                        AnnotationProvider propertyAnnotations)

Creates a FieldTranslator for the given property, or returns null if one can't be constructed. The return value is null if the property type is not known, or if there is no Translator available from the TranslatorSource that is appropriate for the property type.

Parameters:

field - for which a translator is needed

overrideId - id used when looking in the overrideMessages for a message override

overrideMessages - location to look for overriding messages

locale - no longer used in 5.3, may be null

propertyType - type of property editted by the field, used to select the Translator

propertyAnnotations - annotations on the property (not currently used)

Returns:

the field translator, or null

createTranslator

FieldTranslator createTranslator(Field field,
                                 String overrideId,
                                 Messages overrideMessages,
                                 Locale locale,
                                 Translator translator)

Wraps a Translator as a FieldTranslator.

Parameters:

locale - no longer used in 5.3, may be null

createTranslator

FieldTranslator createTranslator(ComponentResources componentResources,
                                 String translatorName)

Creates a translator (used by the translate: binding prefix).