jfxtras.labs.util

Class HeterogeneousBidirectionalBinder<A,B>

java.lang.Object

jfxtras.labs.util.HeterogeneousBidirectionalBinder<A,B>

All Implemented Interfaces:

javafx.beans.value.ChangeListener<java.lang.Object>, javafx.beans.WeakListener

public class HeterogeneousBidirectionalBinder<A,B>
extends java.lang.Object
implements javafx.beans.value.ChangeListener<java.lang.Object>, javafx.beans.WeakListener

A bidirectional object binding between two properties of different types. It is a bindER rather than bindING for two reasons: <ul> <li> We can’t extend the original BidirectionalBinding since it has a private constructor </li> <li> It doesn’t use static methods and it’s a simple object you want to keep a reference around </li> </ul> The bind is effective from the constructor until unbind() is called. It is registered as a weaklistener to both properties. <p> Much like the oiginal BidirectionalBinding using StringConverter, you can have multiple bidirectional binders active at the same time. Because they are glorified listeners multiple binders are activated in order of creation. Still, avoid multiple active binders as the transformations of variables concatenate in usually strange fashion.

Created by carrknight on 4/26/14.

Constructor Summary

Constructors

Constructor and Description
HeterogeneousBidirectionalBinder(javafx.beans.property.Property<A> property1, javafx.beans.property.Property<B> property2, java.util.function.Function<A,B> transformer1To2, java.util.function.Function<B,A> transformer2To1)

Method Summary

Modifier and Type	Method and Description
void	changed(javafx.beans.value.ObservableValue sourceProperty, java.lang.Object oldValue, java.lang.Object newValue) This is the core of the binding.
boolean	equals(java.lang.Object o) equality is just "==".
javafx.beans.property.Property<A>	getProperty1()
javafx.beans.property.Property<B>	getProperty2()
int	hashCode()
void	unbind()
boolean	wasGarbageCollected() copy pasted from the javafx8 source code: http://hg.openjdk.java.net/openjfx/8/master/rt/file/f89b7dc932af/modules/base/src/main/java/com/sun/javafx/binding/BidirectionalBinding.java

Methods inherited from class java.lang.Object

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

Constructor Detail

HeterogeneousBidirectionalBinder

public HeterogeneousBidirectionalBinder(javafx.beans.property.Property<A> property1,
                                        javafx.beans.property.Property<B> property2,
                                        java.util.function.Function<A,B> transformer1To2,
                                        java.util.function.Function<B,A> transformer2To1)

Method Detail

getProperty1

public javafx.beans.property.Property<A> getProperty1()

getProperty2

public javafx.beans.property.Property<B> getProperty2()

changed

public void changed(javafx.beans.value.ObservableValue sourceProperty,
                    java.lang.Object oldValue,
                    java.lang.Object newValue)

This is the core of the binding. It is a method that listens to both properties. It takes as basis the open source javafx method for BidirectionalBinding (here: http://hg.openjdk.java.net/openjfx/8/master/rt/file/f89b7dc932af/modules/base/src/main/java/com/sun/javafx/binding/BidirectionalBinding.java ) the only main difference is that in this method i called the transformers. It’s another unfortunate byproduct of BidirectionalBindings having private constructors.

Specified by:

changed in interface javafx.beans.value.ChangeListener<java.lang.Object>

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

unbind

public void unbind()

wasGarbageCollected

public boolean wasGarbageCollected()

copy pasted from the javafx8 source code: http://hg.openjdk.java.net/openjfx/8/master/rt/file/f89b7dc932af/modules/base/src/main/java/com/sun/javafx/binding/BidirectionalBinding.java

Specified by:

wasGarbageCollected in interface javafx.beans.WeakListener

Returns:

whether either property is null

equals

public boolean equals(java.lang.Object o)

equality is just "==".

Overrides:

equals in class java.lang.Object