org.apache.tapestry.binding
Interface BindingSource

All Known Implementing Classes:

BindingSourceImpl

public interface BindingSource

Used to convert a binding string (from a template or a specification) into an instance of IBinding.

Since:

4.0

Method Summary

IBinding

createBinding(IComponent component, java.lang.String description, java.lang.String reference, java.lang.String defaultBindingType, org.apache.hivemind.Location location) Creates a new binding.

Method Detail

createBinding

IBinding createBinding(IComponent component,
                       java.lang.String description,
                       java.lang.String reference,
                       java.lang.String defaultBindingType,
                       org.apache.hivemind.Location location)

Creates a new binding. The locator is used to identify the type of binding to create as well as configure the binding instance. The locator is either a literal value (resulting in a literal binding) or consists of prefix and a path, i.e., ognl:myProperty.

When a prefix exists and is identified, it is used to select the correct BindingFactory, and the remainder of the path (i.e., myProperty) is passed to the factory. An unrecognized prefix is treated as a literal value (it is often "javascript:" or "http:", etc.).

Parameters:

component - the component for which the binding is created; the component is used as a kind of context for certain types of bindings (for example, the root object when evaluating OGNL expressions).

description - description for the new binding

reference - the binding reference used to create the binding, possibly including a prefix to define the type. If the reference does not include a prefix, then the defaultBindingType is used as the prefix

defaultbindingType - binding type to use when no prefix is provided in the reference or doesn't match a known binding factory.

location - location used to report errors in the binding