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

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