org.apache.tapestry5.services
Interface BindingSource

All Known Implementing Classes:

BindingSourceImpl

@UsesMappedConfiguration(value=BindingFactory.class)
public interface BindingSource

Used to acquire bindings for component parameters. The BindingSource service strips off the binding prefix to locate a BindingFactory.

Method Summary

Binding	newBinding(String description, ComponentResources container, ComponentResources component, String defaultPrefix, String expression, Location location) Examines the expression and strips off the leading prefix.
Binding	newBinding(String description, ComponentResources container, String defaultPrefix, String expression) A simpler version of newBinding(String, ComponentResources, ComponentResources, String, String, Location) that defaults the values for several parameters.

Method Detail

newBinding

Binding newBinding(String description,
                   ComponentResources container,
                   ComponentResources component,
                   String defaultPrefix,
                   String expression,
                   Location location)

Examines the expression and strips off the leading prefix. The prefix is used to choose the appropriate BindingFactory, which receives the description, the expression (after the prefix), and the location. If the prefix doesn't exist, or if there's no prefix, then the factory for the default prefix (often "literal") is used (and passed the full prefix).

The binding represents a connection between the container and the component (the component is usually the child of the container, though in a few cases, it is the component itself). In most cases, the expression is evaluated in terms of the resources of the container and the component is ignored.

Parameters:

description - description of the binding, such as "parameter foo"

container - typically, the parent of the component

component - the component whose parameter is to be bound

defaultPrefix - the default prefix used when the expression itself does not have a prefix

expression - the binding

location - location assigned to the binding (or null if not known)

Returns:

a binding

newBinding

Binding newBinding(String description,
                   ComponentResources container,
                   String defaultPrefix,
                   String expression)

A simpler version of newBinding(String, ComponentResources, ComponentResources, String, String, Location) that defaults the values for several parameters. This is used in most cases. The default binding prefix will be "prop". Most often, this is used to create a new default binding.

Parameters:

description - description of the binding, such as "parameter foo"

container - typically, the parent of the component. This value will be used as the container and the component, so whatever type of expression is evaluated, will be evaulated in terms of this component

defaultPrefix - the default prefix used when the expression itself does not have a prefix

expression - the binding

Returns:

a binding