public abstract class BooleanBinding extends BooleanExpression implements Binding<java.lang.Boolean>
Binding
of a boolean
value.
BooleanBinding
provides a simple invalidation-scheme. An extending
class can register dependencies by calling bind(Observable...)
.
If One of the registered dependencies becomes invalid, this
BooleanBinding
is marked as invalid. With
unbind(Observable...)
listening to dependencies can be stopped.
To provide a concrete implementation of this class, the method
computeValue()
has to be implemented to calculate the value of this
binding based on the current state of the dependencies. It is called when
get()
is called for an invalid binding.
See DoubleBinding
for an example how this base class can be extended.
Binding
,
BooleanExpression
Constructor and Description |
---|
BooleanBinding() |
Modifier and Type | Method and Description |
---|---|
void |
addListener(ChangeListener<? super java.lang.Boolean> listener)
Adds a
ChangeListener which will be notified whenever the value
of the ObservableValue changes. |
void |
addListener(InvalidationListener listener)
Adds an
InvalidationListener which will be notified whenever the
Observable becomes invalid. |
protected void |
bind(Observable... dependencies)
Start observing the dependencies for changes.
|
protected abstract boolean |
computeValue()
Calculates the current value of this binding.
|
void |
dispose()
A default implementation of
dispose() that is empty. |
boolean |
get()
Returns the result of
computeValue() . |
ObservableList<?> |
getDependencies()
A default implementation of
getDependencies() that returns an
empty ObservableList . |
void |
invalidate()
Mark a binding as invalid.
|
boolean |
isValid()
Checks if a binding is valid.
|
protected void |
onInvalidating()
The method onInvalidating() can be overridden by extending classes to
react, if this binding becomes invalid.
|
void |
removeListener(ChangeListener<? super java.lang.Boolean> listener)
Removes the given listener from the list of listeners, that are notified
whenever the value of the
ObservableValue changes. |
void |
removeListener(InvalidationListener listener)
Removes the given listener from the list of listeners, that are notified
whenever the value of the
Observable becomes invalid. |
java.lang.String |
toString()
Returns a string representation of this
BooleanBinding object. |
protected void |
unbind(Observable... dependencies)
Stop observing the dependencies for changes.
|
and, asString, booleanExpression, getValue, isEqualTo, isNotEqualTo, not, or
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getValue
public void addListener(InvalidationListener listener)
Observable
InvalidationListener
which will be notified whenever the
Observable
becomes invalid. If the same
listener is added more than once, then it will be notified more than
once. That is, no check is made to ensure uniqueness.
Note that the same actual InvalidationListener
instance may be
safely registered for different Observables
.
The Observable
stores a strong reference to the listener
which will prevent the listener from being garbage collected and may
result in a memory leak. It is recommended to either unregister a
listener by calling removeListener
after use or to use an instance of
WeakInvalidationListener
avoid this situation.
addListener
in interface Observable
listener
- The listener to registerObservable.removeListener(InvalidationListener)
public void removeListener(InvalidationListener listener)
Observable
Observable
becomes invalid.
If the given listener has not been previously registered (i.e. it was never added) then this method call is a no-op. If it had been previously added then it will be removed. If it had been added more than once, then only the first occurrence will be removed.
removeListener
in interface Observable
listener
- The listener to removeObservable.addListener(InvalidationListener)
public void addListener(ChangeListener<? super java.lang.Boolean> listener)
ObservableValue
ChangeListener
which will be notified whenever the value
of the ObservableValue
changes. If the same listener is added
more than once, then it will be notified more than once. That is, no
check is made to ensure uniqueness.
Note that the same actual ChangeListener
instance may be safely
registered for different ObservableValues
.
The ObservableValue
stores a strong reference to the listener
which will prevent the listener from being garbage collected and may
result in a memory leak. It is recommended to either unregister a
listener by calling removeListener
after use or to use an instance of
WeakChangeListener
avoid this situation.
addListener
in interface ObservableValue<java.lang.Boolean>
listener
- The listener to registerObservableValue.removeListener(ChangeListener)
public void removeListener(ChangeListener<? super java.lang.Boolean> listener)
ObservableValue
ObservableValue
changes.
If the given listener has not been previously registered (i.e. it was never added) then this method call is a no-op. If it had been previously added then it will be removed. If it had been added more than once, then only the first occurrence will be removed.
removeListener
in interface ObservableValue<java.lang.Boolean>
listener
- The listener to removeObservableValue.addListener(ChangeListener)
protected final void bind(Observable... dependencies)
dependencies
- the dependencies to observeprotected final void unbind(Observable... dependencies)
dependencies
- the dependencies to stop observingpublic void dispose()
dispose()
that is empty.public ObservableList<?> getDependencies()
getDependencies()
that returns an
empty ObservableList
.getDependencies
in interface Binding<java.lang.Boolean>
ObservableList
public final boolean get()
computeValue()
. The method
computeValue()
is only called if the binding is invalid. The
result is cached and returned if the binding did not become invalid since
the last call of get()
.get
in interface ObservableBooleanValue
protected void onInvalidating()
public final void invalidate()
Binding
Binding
next time it is request.invalidate
in interface Binding<java.lang.Boolean>
public final boolean isValid()
Binding
protected abstract boolean computeValue()
Classes extending BooleanBinding
have to provide an
implementation of computeValue
.
public java.lang.String toString()
BooleanBinding
object.toString
in class java.lang.Object
BooleanBinding
object.Copyright (c) 2008, 2014, Oracle and/or its affiliates. All rights reserved.