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 DataBindingContext
context
-
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 void
dispose()
Disposes of this Binding.IObservable
getModel()
Returns the model observableIObservableList<IObservable>
getModels()
Returns anIObservableList
containing the model observables (if any) that are being tracked by this validation status provider.IObservable
getTarget()
Returns the target observableIObservableList<IObservable>
getTargets()
Returns anIObservableList
containing the target observables (if any) that are being tracked by this validation status provider.void
init(DataBindingContext context)
Initializes this binding with the given context and adds it to the list of bindings of the context.protected abstract void
postInit()
Called byinit(DataBindingContext)
after adding this binding to the context.protected abstract void
preInit()
Called byinit(DataBindingContext)
after settingcontext
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 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
- the data binding context
-
preInit
protected abstract void preInit()
Called byinit(DataBindingContext)
after settingcontext
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 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:
dispose
in classValidationStatusProvider
-
getTarget
public IObservable getTarget()
Returns the target observable- Returns:
- the target observable
-
getTargets
public IObservableList<IObservable> getTargets()
Description copied from class:ValidationStatusProvider
Returns anIObservableList
containing the target observables (if any) that are being tracked by this validation status provider.- Specified by:
getTargets
in 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:ValidationStatusProvider
Returns anIObservableList
containing the model observables (if any) that are being tracked by this validation status provider.- Specified by:
getModels
in classValidationStatusProvider
- Returns:
- an
IObservableList
(may be empty)
-
-