Package org.eclipse.core.databinding
Class Binding
- java.lang.Object
-
- org.eclipse.core.databinding.ValidationStatusProvider
-
- org.eclipse.core.databinding.Binding
-
- Direct Known Subclasses:
ListBinding,SetBinding
public abstract class Binding extends ValidationStatusProvider
This abstract class represents a binding between a model and a target. Newly created instances need to be added to a data binding context usinginit(DataBindingContext).- Since:
- 1.0
-
-
Field Summary
Fields Modifier and Type Field Description protected DataBindingContextcontext-
Fields inherited from class org.eclipse.core.databinding.ValidationStatusProvider
disposed
-
-
Constructor Summary
Constructors Constructor Description Binding(IObservable target, IObservable model)Creates a new binding.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description voiddispose()Disposes of this Binding.IObservablegetModel()Returns the model observableIObservableList<IObservable>getModels()Returns anIObservableListcontaining the model observables (if any) that are being tracked by this validation status provider.IObservablegetTarget()Returns the target observableIObservableList<IObservable>getTargets()Returns anIObservableListcontaining the target observables (if any) that are being tracked by this validation status provider.voidinit(DataBindingContext context)Initializes this binding with the given context and adds it to the list of bindings of the context.protected abstract voidpostInit()Called byinit(DataBindingContext)after adding this binding to the context.protected abstract voidpreInit()Called byinit(DataBindingContext)after settingcontextbut before adding this binding to the context.abstract voidupdateModelToTarget()Updates the target's state from the model's state at the next reasonable opportunity.abstract voidupdateTargetToModel()Updates the model's state from the target's state at the next reasonable opportunity.abstract voidvalidateModelToTarget()Validates the model's state at the next reasonable opportunity.abstract voidvalidateTargetToModel()Validates the target's state at the next reasonable opportunity.-
Methods inherited from class org.eclipse.core.databinding.ValidationStatusProvider
getValidationStatus, isDisposed
-
-
-
-
Field Detail
-
context
protected DataBindingContext context
-
-
Constructor Detail
-
Binding
public Binding(IObservable target, IObservable model)
Creates a new binding.- Parameters:
target- target observablemodel- 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 byinit(DataBindingContext)after settingcontextbut 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 byinit(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.
-
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().- Overrides:
disposein classValidationStatusProvider
-
getTarget
public IObservable getTarget()
Returns the target observable- Returns:
- the target observable
-
getTargets
public IObservableList<IObservable> getTargets()
Description copied from class:ValidationStatusProviderReturns anIObservableListcontaining the target observables (if any) that are being tracked by this validation status provider.- Specified by:
getTargetsin classValidationStatusProvider- Returns:
- an
IObservableList(may be empty)
-
getModel
public IObservable getModel()
Returns the model observable- Returns:
- the model observable
-
getModels
public IObservableList<IObservable> getModels()
Description copied from class:ValidationStatusProviderReturns anIObservableListcontaining the model observables (if any) that are being tracked by this validation status provider.- Specified by:
getModelsin classValidationStatusProvider- Returns:
- an
IObservableList(may be empty)
-
-