org.apache.tapestry5.services
Interface ComponentDefaultProvider

All Known Implementing Classes:
ComponentDefaultProviderImpl

public interface ComponentDefaultProvider

A service that can be injected into a component to provide common defaults for various types of parameters.


Method Summary
 Binding defaultBinding(String parameterName, ComponentResources resources)
          Checks to see if the container of the component (identified by its resources) contains a property matching the component's id.
 String defaultLabel(ComponentResources resources)
          Computes the default label for the component (which will generally be a Field).
 FieldTranslator defaultTranslator(String parameterName, ComponentResources resources)
          Deprecated. Use defaultTranslatorBinding(String, org.apache.tapestry5.ComponentResources) instead
 Binding defaultTranslatorBinding(String parameterName, ComponentResources resources)
          Provides a binding that itself provides the field translator.
 FieldValidator defaultValidator(String parameterName, ComponentResources resources)
          Deprecated. Use defaultValidatorBinding(String, org.apache.tapestry5.ComponentResources) instead
 Binding defaultValidatorBinding(String parameterName, ComponentResources resources)
          Provides a binding that itself provides the field translator.
 ValueEncoder defaultValueEncoder(String parameterName, ComponentResources resources)
          Gets or creates a value encoder based on the type of the named parameter.
 

Method Detail

defaultLabel

String defaultLabel(ComponentResources resources)
Computes the default label for the component (which will generally be a Field).

Parameters:
resources -
Returns:
the label, either extracted from the component's container's message catalog, or derived from the component's ComponentResourcesCommon.getId().

defaultBinding

Binding defaultBinding(String parameterName,
                       ComponentResources resources)
Checks to see if the container of the component (identified by its resources) contains a property matching the component's id. If so, a binding for that property is returned. This is usually the default for a Field's value parameter (or equivalent).

Parameters:
parameterName - the name of the parameter
resources - the resources of the component for which a binding is needed
Returns:
the binding, or null if the container does not have a matching property

defaultValueEncoder

ValueEncoder defaultValueEncoder(String parameterName,
                                 ComponentResources resources)
Gets or creates a value encoder based on the type of the named parameter. ValueEncoders are cached based on type.

Parameters:
parameterName - the name of the parameter whose type is used to locate a ValueEncoderFactory
resources - the resources of the component, from which parameter and its type are extracted
Returns:
the value encoder, or null if the type of the parameter is not known

defaultTranslator

FieldTranslator defaultTranslator(String parameterName,
                                  ComponentResources resources)
Deprecated. Use defaultTranslatorBinding(String, org.apache.tapestry5.ComponentResources) instead

Provides a translator based on the bound parameter type, if possible.

Parameters:
parameterName -
resources -
Returns:
the translator, or null

defaultTranslatorBinding

Binding defaultTranslatorBinding(String parameterName,
                                 ComponentResources resources)
Provides a binding that itself provides the field translator.

Parameters:
parameterName -
resources -
Returns:
binding that provides the FieldTranslator

defaultValidator

FieldValidator defaultValidator(String parameterName,
                                ComponentResources resources)
Deprecated. Use defaultValidatorBinding(String, org.apache.tapestry5.ComponentResources) instead

Provides a validator based on the bound parameter type. If the property type of the parameter is not known, then a no-op validator is returned.

Parameters:
parameterName -
resources -
Returns:
the validator, possibly a no-op validator

defaultValidatorBinding

Binding defaultValidatorBinding(String parameterName,
                                ComponentResources resources)
Provides a binding that itself provides the field translator.

Parameters:
parameterName -
resources -
Returns:
binding that provides the FieldTranslator


Copyright © 2003-2012 The Apache Software Foundation.