Eclipse Platform
Release 3.3

org.eclipse.core.databinding
Class Binding

java.lang.Object
  extended byorg.eclipse.core.databinding.Binding
Direct Known Subclasses:
ListBinding

public abstract class Binding
extends Object

This abstract class represents a binding between a model and a target. Newly created instances need to be added to a data binding context using init(DataBindingContext).

Since:
1.0

Field Summary
protected  DataBindingContext context
           
protected  boolean disposed
           
 
Constructor Summary
Binding(IObservable target, IObservable model)
          Creates a new binding.
 
Method Summary
 void dispose()
          Disposes of this Binding.
 IObservable getModel()
           
 IObservable getTarget()
           
abstract  IObservableValue getValidationStatus()
           
 void init(DataBindingContext context)
          Initializes this binding with the given context and adds it to the list of bindings of the context.
 boolean isDisposed()
           
protected abstract  void postInit()
          Called by init(DataBindingContext) after adding this binding to the context.
protected abstract  void preInit()
          Called by init(DataBindingContext) after setting context but before adding this binding to the context.
abstract  void updateModelToTarget()
          Updates the target's state from the model's state at the next reasonable opportunity.
abstract  void updateTargetToModel()
          Updates the model's state from the target's state at the next reasonable opportunity.
abstract  void validateModelToTarget()
          Validates the model's state at the next reasonable opportunity.
abstract  void validateTargetToModel()
          Validates the target's state at the next reasonable opportunity.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

context

protected DataBindingContext context

disposed

protected boolean disposed
Constructor Detail

Binding

public Binding(IObservable target,
               IObservable model)
Creates a new binding.

Parameters:
target - target observable
model - model observable
Method Detail

init

public final void init(DataBindingContext context)
Initializes this binding with the given context and adds it to the list of bindings of the context.

Subclasses may extend, but must call the super implementation.

Parameters:
context -

preInit

protected abstract void preInit()
Called by init(DataBindingContext) after setting context but before adding this binding to the context. Subclasses may use this method to perform initialization that could not be done in the constructor. Care should be taken not to cause any events while running this method.


postInit

protected abstract void postInit()
Called by init(DataBindingContext) after adding this binding to the context. Subclasses may use this method to perform initialization that may cause events to be fired, including BindingEvents that are forwarded to the data binding context.


getValidationStatus

public abstract IObservableValue getValidationStatus()
Returns:
an observable value containing the current validation status

updateTargetToModel

public abstract void updateTargetToModel()
Updates the model's state from the target's state at the next reasonable opportunity. There is no guarantee that the state will have been updated by the time this call returns.


updateModelToTarget

public abstract void updateModelToTarget()
Updates the target's state from the model's state at the next reasonable opportunity. There is no guarantee that the state will have been updated by the time this call returns.


validateTargetToModel

public abstract void validateTargetToModel()
Validates the target's state at the next reasonable opportunity. There is no guarantee that the validation status will have been updated by the time this call returns.


validateModelToTarget

public abstract void validateModelToTarget()
Validates the model's state at the next reasonable opportunity. There is no guarantee that the validation status will have been updated by the time this call returns.


dispose

public void dispose()
Disposes of this Binding. Subclasses may extend, but must call super.dispose().


isDisposed

public boolean isDisposed()
Returns:
true if the binding has been disposed. false otherwise.

getTarget

public IObservable getTarget()
Returns:
target observable

getModel

public IObservable getModel()
Returns:
model observable

Eclipse Platform
Release 3.3

Guidelines for using Eclipse APIs.

Copyright (c) IBM Corp. and others 2000, 2007. All rights reserved.