javax.beans.binding.ext
Interface BindingTarget


public interface BindingTarget

BindingTarget allows the target of a binding operation to control the binding.

A bound Binding checks the target if it implements BindingTargetProvider. If the target implements BindingTargetProvider, then createBindingTarget is invoked on it supplying a BindingController.

BindingTarget is primarily useful for targets that need to customize how the binding works, such as a JTable binding.


Method Summary
 void bind(Binding.BindingController controller, java.lang.String property)
          Notifies this BindingTarget that it has become the target of an active binding.
 void sourceValueStateChanged(Binding.BindingController controller, java.lang.String property)
          Notification that the value state of the source has changed.
 void unbind(Binding.BindingController controller, java.lang.String property)
          Notifies this BindingTarget that it is no longer the target of an active binding.
 

Method Detail

bind

void bind(Binding.BindingController controller,
          java.lang.String property)
Notifies this BindingTarget that it has become the target of an active binding.

Parameters:
controller - describes the binding
property - the property being bound to
Throws:
java.lang.NullPointerException - if controller or property is null
java.lang.IllegalArgumentException - if property is not a valid property, or the binding does not contain necessary information for this BindingTarget
java.lang.IllegalStateException - if already bound

unbind

void unbind(Binding.BindingController controller,
            java.lang.String property)
Notifies this BindingTarget that it is no longer the target of an active binding.

Parameters:
controller - describes the binding
property - the property being bound to
Throws:
java.lang.NullPointerException - if controller or property is null
java.lang.IllegalArgumentException - if property is not a valid property
java.lang.IllegalStateException - if not bound

sourceValueStateChanged

void sourceValueStateChanged(Binding.BindingController controller,
                             java.lang.String property)
Notification that the value state of the source has changed.

Parameters:
controller - identifies the binding
property - the property