Module MaterialFX

Package io.github.palexdev.materialfx.beans.properties.synced

Class SynchronizedObjectProperty<T>

java.lang.Object

javafx.beans.binding.ObjectExpression<T>

javafx.beans.property.ReadOnlyObjectProperty<T>

javafx.beans.property.ObjectProperty<T>

javafx.beans.property.ObjectPropertyBase<T>

javafx.beans.property.SimpleObjectProperty<T>

javafx.beans.property.ReadOnlyObjectWrapper<T>

io.github.palexdev.materialfx.beans.properties.synced.SynchronizedObjectProperty<T>

Type Parameters:

T - the type of the wrapped Object

All Implemented Interfaces:

SynchronizedProperty<T>, Observable, Property<T>, ReadOnlyProperty<T>, ObservableObjectValue<T>, ObservableValue<T>, WritableObjectValue<T>, WritableValue<T>

public class SynchronizedObjectProperty<T>
extends ReadOnlyObjectWrapper<T>
implements SynchronizedProperty<T>

Implementation of SynchronizedProperty for generic values.

Nested Class Summary

Nested classes/interfaces inherited from interface io.github.palexdev.materialfx.beans.properties.base.SynchronizedProperty

SynchronizedProperty.Helper

Constructor Summary

Constructors

Constructor	Description
SynchronizedObjectProperty()
SynchronizedObjectProperty(Object bean, String name)
SynchronizedObjectProperty(Object bean, String name, T initialValue)
SynchronizedObjectProperty(T initialValue)

Method Summary

Modifier and Type	Method	Description
void	awake()	Awakes the property by setting SynchronizedProperty.waiting() to false.
void	bind(ObservableValue<? extends T> source)	Creates a unidirectional bindings with the given observable.
void	bindBidirectional(Property<T> other)	Creates a bidirectional bindings between this property and the given property.
void	clearBidirectional()	Delegate method for BiBindingManager.disposeFor(ObservableValue).
protected void	fireValueChangedEvent()
boolean	isBound()	Overridden to check the BindingManager.isBound(ObservableValue) flag value and BindingManager.isIgnoreBinding(ObservableValue).
boolean	isWaiting()
void	setAndWait(T value, ObservableValue<?> observable)	Sets this property's state to "waiting" then uses ExecutionUtils.executeWhen(Observable, Runnable, boolean, Supplier, boolean) to "awake" the property when the given observable changes.
void	unbind()	Overridden to call BindingManager.unbind(ObservableValue).
void	unbindBidirectional(Property<T> other)	Overridden to call BiBindingManager.unbind(ObservableValue, ObservableValue).
ReadOnlyBooleanProperty	waiting()

Methods inherited from class javafx.beans.property.ReadOnlyObjectWrapper

getReadOnlyProperty

Methods inherited from class javafx.beans.property.SimpleObjectProperty

getBean, getName

Methods inherited from class javafx.beans.property.ObjectPropertyBase

addListener, addListener, get, invalidated, removeListener, removeListener, set, toString

Methods inherited from class javafx.beans.property.ObjectProperty

setValue

Methods inherited from class javafx.beans.binding.ObjectExpression

asString, asString, asString, getValue, isEqualTo, isEqualTo, isNotEqualTo, isNotEqualTo, isNotNull, isNull, objectExpression

Methods inherited from class java.lang.Object

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

Methods inherited from interface javafx.beans.Observable

addListener, removeListener

Methods inherited from interface javafx.beans.value.ObservableValue

addListener, getValue, removeListener

Methods inherited from interface javafx.beans.property.ReadOnlyProperty

getBean, getName

Methods inherited from interface javafx.beans.value.WritableValue

getValue, setValue

Constructor Details

SynchronizedObjectProperty

public SynchronizedObjectProperty()

SynchronizedObjectProperty

public SynchronizedObjectProperty(T initialValue)

SynchronizedObjectProperty

public SynchronizedObjectProperty(Object bean,
 String name)

SynchronizedObjectProperty

public SynchronizedObjectProperty(Object bean,
 String name,
 T initialValue)

Method Details

setAndWait

public void setAndWait(T value,
 ObservableValue<?> observable)

Sets this property's state to "waiting" then uses ExecutionUtils.executeWhen(Observable, Runnable, boolean, Supplier, boolean) to "awake" the property when the given observable changes.

Just like JavaFX properties if the new value is the same as the current value the method returns and does nothing.

Specified by:

setAndWait in interface SynchronizedProperty<T>

Parameters:

value - the new value of the property

observable - the observable to wait for

isWaiting

public boolean isWaiting()

Specified by:

isWaiting in interface SynchronizedProperty<T>

Returns:

whether this property is in waiting state

waiting

public ReadOnlyBooleanProperty waiting()

Specified by:

waiting in interface SynchronizedProperty<T>

Returns:

the waiting state property as a read only property

awake

public void awake()

Awakes the property by setting SynchronizedProperty.waiting() to false.

This method should never be invoked by the user, the awakening is automatically managed by the property. If for some reason the property stays in waiting state you are probably doing something wrong.

Specified by:

awake in interface SynchronizedProperty<T>

fireValueChangedEvent

protected void fireValueChangedEvent()

Overridden to not fire a change event if waiting() is true.

Overrides:

fireValueChangedEvent in class ReadOnlyObjectWrapper<T>

bind

public void bind(ObservableValue<? extends T> source)

Creates a unidirectional bindings with the given observable.

The binding is created using the new BindingManager mechanism.

If the property is already bound it is automatically unbound before bindings to the new observable.

Specified by:

bind in interface Property<T>

Overrides:

bind in class ObjectPropertyBase<T>

Throws:

IllegalArgumentException - if the given observable is the property itself

See Also:

• BindingManager

bindBidirectional

public void bindBidirectional(Property<T> other)

Creates a bidirectional bindings between this property and the given property.

The binding is created using the new BiBindingManager mechanism.

If the property is already bound unidirectionally it is automatically unbound.

If the property is already bound bidirectionally it won't be automatically unbound, just like JavaFX, this way you can have multiple bidirectional bindings

Specified by:

bindBidirectional in interface Property<T>

Overrides:

bindBidirectional in class ObjectProperty<T>

Throws:

IllegalArgumentException - if the given observable is the property itself

See Also:

• BiBindingManager

unbind

public void unbind()

Overridden to call BindingManager.unbind(ObservableValue).

Specified by:

unbind in interface Property<T>

Overrides:

unbind in class ObjectPropertyBase<T>

unbindBidirectional

public void unbindBidirectional(Property<T> other)

Overridden to call BiBindingManager.unbind(ObservableValue, ObservableValue).

Specified by:

unbindBidirectional in interface Property<T>

Overrides:

unbindBidirectional in class ObjectProperty<T>

clearBidirectional

public void clearBidirectional()

Delegate method for BiBindingManager.disposeFor(ObservableValue).

isBound

public boolean isBound()

Overridden to check the BindingManager.isBound(ObservableValue) flag value and BindingManager.isIgnoreBinding(ObservableValue).

Specified by:

isBound in interface Property<T>

Overrides:

isBound in class ObjectPropertyBase<T>

Returns:

true only if `BindingManager.isBound()` is true and `isIgnoreBound()` is false