Class BooleanExpression

java.lang.Object

javafx.beans.binding.BooleanExpression

All Implemented Interfaces:

Observable, ObservableBooleanValue, ObservableValue<Boolean>

Direct Known Subclasses:

BooleanBinding, ReadOnlyBooleanProperty

public abstract class BooleanExpression
extends Object
implements ObservableBooleanValue

BooleanExpression is an ObservableBooleanValue plus additional convenience methods to generate bindings in a fluent style.

A concrete sub-class of BooleanExpression has to implement the method ObservableBooleanValue.get(), which provides the actual value of this expression.

Since:

JavaFX 2.0

Constructor Summary

Constructors

Constructor	Description
BooleanExpression()	Creates a default BooleanExpression.

Method Summary

Modifier and Type	Method	Description
BooleanBinding	and(ObservableBooleanValue other)	Creates a new BooleanExpression that performs the conditional AND-operation on this BooleanExpression and a ObservableBooleanValue.
ObjectExpression<Boolean>	asObject()	Creates an ObjectExpression that holds the value of this BooleanExpression.
StringBinding	asString()	Creates a StringBinding that holds the value of this BooleanExpression turned into a String.
static BooleanExpression	booleanExpression(ObservableBooleanValue value)	Returns a BooleanExpression that wraps a ObservableBooleanValue.
static BooleanExpression	booleanExpression(ObservableValue<Boolean> value)	Returns a BooleanExpression that wraps an ObservableValue.
Boolean	getValue()	Returns the current value of this ObservableValue
BooleanBinding	isEqualTo(ObservableBooleanValue other)	Creates a new BooleanExpression that holds true if this and another ObservableBooleanValue are equal.
BooleanBinding	isNotEqualTo(ObservableBooleanValue other)	Creates a new BooleanExpression that holds true if this and another ObservableBooleanValue are equal.
BooleanBinding	not()	Creates a new BooleanExpression that calculates the negation of this BooleanExpression.
BooleanBinding	or(ObservableBooleanValue other)	Creates a new BooleanExpression that performs the conditional OR-operation on this BooleanExpression and a ObservableBooleanValue.

Methods declared in class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods declared in interface Observable

addListener, removeListener, subscribe

Modifier and Type	Method	Description
void	addListener(InvalidationListener listener)	Adds an InvalidationListener which will be notified whenever the Observable becomes invalid.
void	removeListener(InvalidationListener listener)	Removes the given listener from the list of listeners, that are notified whenever the value of the Observable becomes invalid.
default Subscription	subscribe(Runnable invalidationSubscriber)	Creates a Subscription on this Observable which calls invalidationSubscriber whenever it becomes invalid.

Methods declared in interface ObservableBooleanValue

get

Modifier and Type	Method	Description
boolean	get()	Returns the current value of this ObservableBooleanValue.

Methods declared in interface ObservableValue

addListener, flatMap, map, orElse, removeListener, subscribe, subscribe, when

Modifier and Type	Method	Description
void	addListener(ChangeListener<? super Boolean> listener)	Adds a ChangeListener which will be notified whenever the value of the ObservableValue changes.
default <U> ObservableValue<U>	flatMap(Function<? super Boolean, ? extends ObservableValue<? extends U>> mapper)	Returns an ObservableValue that holds the value of an ObservableValue produced by applying the given mapping function on this value.
default <U> ObservableValue<U>	map(Function<? super Boolean, ? extends U> mapper)	Returns an ObservableValue that holds the result of applying the given mapping function on this value.
default ObservableValue<Boolean>	orElse(Boolean constant)	Returns an ObservableValue that holds this value, or the given constant if it is null.
void	removeListener(ChangeListener<? super Boolean> listener)	Removes the given listener from the list of listeners that are notified whenever the value of the ObservableValue changes.
default Subscription	subscribe(BiConsumer<? super Boolean, ? super Boolean> changeSubscriber)	Creates a Subscription on this ObservableValue which calls the given changeSubscriber with the old and new value whenever its value changes.
default Subscription	subscribe(Consumer<? super Boolean> valueSubscriber)	Creates a Subscription on this ObservableValue which immediately provides the current value to the given valueSubscriber, followed by any subsequent values whenever its value changes.
default ObservableValue<Boolean>	when(ObservableValue<Boolean> condition)	Returns an ObservableValue that holds this value and is updated only when condition holds true.

Constructor Details

BooleanExpression

public BooleanExpression()

Creates a default BooleanExpression.

Method Details

getValue

public Boolean getValue()

Description copied from interface: ObservableValue

Returns the current value of this ObservableValue

Specified by:

getValue in interface ObservableValue<Boolean>

Returns:

The current value

booleanExpression

public static BooleanExpression booleanExpression(ObservableBooleanValue value)

Returns a BooleanExpression that wraps a ObservableBooleanValue. If the ObservableBooleanValue is already a BooleanExpression, it will be returned. Otherwise a new BooleanBinding is created that is bound to the ObservableBooleanValue.

Parameters:

value - The source ObservableBooleanValue

Returns:

A BooleanExpression that wraps the ObservableBooleanValue if necessary

Throws:

NullPointerException - if value is null

booleanExpression

public static BooleanExpression booleanExpression(ObservableValue<Boolean> value)

Returns a BooleanExpression that wraps an ObservableValue. If the ObservableValue is already a BooleanExpression, it will be returned. Otherwise a new BooleanBinding is created that is bound to the ObservableValue. Note: null values will be interpreted as "false".

Parameters:

value - The source ObservableValue

Returns:

A BooleanExpression that wraps the ObservableValue if necessary

Throws:

NullPointerException - if value is null

Since:

JavaFX 8.0

and

public BooleanBinding and(ObservableBooleanValue other)

Creates a new BooleanExpression that performs the conditional AND-operation on this BooleanExpression and a ObservableBooleanValue.

Parameters:

other - the other ObservableBooleanValue

Returns:

the new BooleanExpression

Throws:

NullPointerException - if other is null

or

public BooleanBinding or(ObservableBooleanValue other)

Creates a new BooleanExpression that performs the conditional OR-operation on this BooleanExpression and a ObservableBooleanValue.

Parameters:

other - the other ObservableBooleanValue

Returns:

the new BooleanExpression

Throws:

NullPointerException - if other is null

not

public BooleanBinding not()

Creates a new BooleanExpression that calculates the negation of this BooleanExpression.

Returns:

the new BooleanExpression

isEqualTo

public BooleanBinding isEqualTo(ObservableBooleanValue other)

Creates a new BooleanExpression that holds true if this and another ObservableBooleanValue are equal.

Parameters:

other - the other ObservableBooleanValue

Returns:

the new BooleanExpression

Throws:

NullPointerException - if other is null

isNotEqualTo

public BooleanBinding isNotEqualTo(ObservableBooleanValue other)

Creates a new BooleanExpression that holds true if this and another ObservableBooleanValue are equal.

Parameters:

other - the other ObservableBooleanValue

Returns:

the new BooleanExpression

Throws:

NullPointerException - if other is null

asString

public StringBinding asString()

Creates a StringBinding that holds the value of this BooleanExpression turned into a String. If the value of this BooleanExpression changes, the value of the StringBinding will be updated automatically.

Returns:

the new StringBinding

asObject

public ObjectExpression<Boolean> asObject()

Creates an ObjectExpression that holds the value of this BooleanExpression. If the value of this BooleanExpression changes, the value of the ObjectExpression will be updated automatically.

Returns:

the new ObjectExpression

Since:

JavaFX 8.0