Home » tapestry-src-5.0.19 » org.apache.tapestry5 » [javadoc | source]
org.apache.tapestry5
public interface: Binding [javadoc | source]

All Implemented Interfaces:
    AnnotationProvider

All Known Implementing Classes:
    AttributeExpansionBinding, BlockBinding, PropBinding, AssetBinding, RenderVariableBinding, ComponentBinding, VariantBinding, LiteralBinding, InheritedBinding, AbstractBinding

A binding is a connection between a component and its container (another component), that allows the embedded component to gain access to resources defined by the container. Resources can represent any kind of value that can be obtained from the parent component, but is often a JavaBean property that can be read and updated. Different implementations of Binding as used to access different kinds of resources of the container.

A binding ultimately must provide access to the underlying annotations. In most cases, there are no annotations, but bindings that ultimate invoke methods or read and update fields must provide access to those annotations.
Method from org.apache.tapestry5.Binding Summary:
get,   getBindingType,   isInvariant,   set
Method from org.apache.tapestry5.Binding Detail:
 public Object get()
    Reads the current value of the property (or other resource). When reading properties of objects that are primitive types, this will return an instance of the wrapper type. In some cases, a binding is read only and this method will throw a runtime exception.
 public Class getBindingType()
    Returns the type of the binding, either the type of resource exposed by the binding, or the type of the property bound.
 public boolean isInvariant()
    Returns true if the value of the binding does not ever change. Components will often cache such values aggressively.
 public  void set(Object value)
    Updates the current value. Most types of bindings are read-only, and this method will throw a runtime exception. It is the caller's responsibility to ensure that the value passed in is of the appropriate type.