JavaFX Properties

A interface Property tem cinco métodos:

void bind(ObservableValue<? extends T> observable);
void unbind();
boolean isBound();
void bindBidirectional(Property<T> other);
void unbindBidirectional(Property<T> other);

void bind(ObservableValue<? extends T> observable);

void unbind();

boolean isBound();

void bindBidirectional(Property<T> other);

void unbindBidirectional(Property<T> other);

O método bind() estabelece um unidirectional binding entre o Property e o ObservableValue. O método unbind() fornece o binding, e o método isBound() reporta se um unidirectional binding é um efeito.

Uma vez em vigor, o unidirectional binding estabelece uma dependência do primeiro para o último. O método set() ou setValue() na Property irá lançar um RuntimeException, e o método get() ou getValue() irá retornar o valor do ObservableValue.

O método bindBidirectional() estabelece um bidirectional binding entre dois objetos Property. O método unbindBidirectional() o libera. Uma vez em vigor, chama o set() ou setValue() ou qualquer Property fará com que os valores de ambos os objetos sejam atualizados.

Cuidado: cada Property pode ter mais de um binding unidirecional ativo por vez. Ele pode ter vários bidirectional bindings que você quiser. O método isBound() refere-se ao unidirectional bindings. Chamando uma segunda vez o bind() com um diferente ObservableValue irá unbind o anterior e substituir pelo o novo.

Para resumir o Property pode guardar um valor, pode avisar quando valores são modificados, e pode ser vinculado a outros para refletir os valores dos objetos vinculados.

Table of Contents

PropertiesExample.java

package main.java.br.com.cursojavanow;

import javafx.beans.InvalidationListener;
import javafx.beans.property.IntegerProperty;
import javafx.beans.property.SimpleIntegerProperty;
import javafx.beans.value.ChangeListener;

public class PropertiesExample {
    private static IntegerProperty i1;

    public static void main(String[] args) {
        createProperty();
        addAndRemoveInvalidationListener();
        addAndRemoveChangeListener();
        bindAndUnbindOnePropertyToAnother();
    }

    private static void createProperty() {
        System.out.println();
        i1 = new SimpleIntegerProperty(1024);
        System.out.println("i1 = " + i1);
        System.out.println("i1.get() = " + i1.get());
        System.out.println("i1.getValue() = "
                + i1.getValue());
    }

    private static void addAndRemoveInvalidationListener() {
        System.out.println();
        final InvalidationListener invalidationListener =
                observable -> {
                    System.out.println(
                            "The observable has been " +
                                    "invalidated: " +
                                    observable + ".");
                };
        i1.addListener(invalidationListener);
        System.out.println("Added invalidation listener.");
        System.out.println("Calling i1.set(2048).");
        i1.set(2048);
        System.out.println("Calling i1.setValue(3072).");
        i1.setValue(3072);
        i1.removeListener(invalidationListener);
        System.out.println("Removed invalidation listener.");
        System.out.println("Calling i1.set(4096).");
        i1.set(4096);
    }

    private static void addAndRemoveChangeListener() {
        System.out.println();
        final ChangeListener<Number> changeListener =
                (observableValue,
                 oldValue,
                 newValue) -> {
                    System.out.println(
                            "The observableValue has " +
                                    "changed: oldValue = " +
                                    oldValue +
                                    ", newValue = " +
                                    newValue);
                };
        i1.addListener(changeListener);
        System.out.println("Added change listener.");
        System.out.println("Calling i1.set(5120).");
        i1.set(5120);
        i1.removeListener(changeListener);
        System.out.println("Removed change listener.");
        System.out.println("Calling i1.set(6144).");
        i1.set(6144);
    }

    private static void bindAndUnbindOnePropertyToAnother() {
        System.out.println();
        IntegerProperty i2 = new SimpleIntegerProperty(0);
        System.out.println("i2.get() = " + i2.get());
        System.out.println("Binding i2 to i1.");
        i2.bind(i1);
        System.out.println("i2.get() = " + i2.get());
        System.out.println("Calling i1.set(7168).");
        i1.set(7168);
        System.out.println("i2.get() = " + i2.get());
        System.out.println("Unbinding i2 from i1.");
        i2.unbind();
        System.out.println("i2.get() = " + i2.get());
        System.out.println("Calling i1.set(8192).");
        i1.set(8192);
        System.out.println("i2.get() = " + i2.get());
    }
}

package main.java.br.com.cursojavanow;

import javafx.beans.InvalidationListener;

import javafx.beans.property.IntegerProperty;

import javafx.beans.property.SimpleIntegerProperty;

import javafx.beans.value.ChangeListener;

public class PropertiesExample {

private static IntegerProperty i1;

public static void main(String[] args) {

createProperty();

addAndRemoveInvalidationListener();

addAndRemoveChangeListener();

bindAndUnbindOnePropertyToAnother();

}

private static void createProperty() {

System.out.println();

i1 = new SimpleIntegerProperty(1024);

System.out.println("i1 = " + i1);

System.out.println("i1.get() = " + i1.get());

System.out.println("i1.getValue() = "

+ i1.getValue());

}

private static void addAndRemoveInvalidationListener() {

System.out.println();

final InvalidationListener invalidationListener =

observable -> {

System.out.println(

"The observable has been " +

"invalidated: " +

observable + ".");

};

i1.addListener(invalidationListener);

System.out.println("Added invalidation listener.");

System.out.println("Calling i1.set(2048).");

i1.set(2048);

System.out.println("Calling i1.setValue(3072).");

i1.setValue(3072);

i1.removeListener(invalidationListener);

System.out.println("Removed invalidation listener.");

System.out.println("Calling i1.set(4096).");

i1.set(4096);

}

private static void addAndRemoveChangeListener() {

System.out.println();

final ChangeListener<Number> changeListener =

(observableValue,

oldValue,

newValue) -> {

System.out.println(

"The observableValue has " +

"changed: oldValue = " +

oldValue +

", newValue = " +

newValue);

};

i1.addListener(changeListener);

System.out.println("Added change listener.");

System.out.println("Calling i1.set(5120).");

i1.set(5120);

i1.removeListener(changeListener);

System.out.println("Removed change listener.");

System.out.println("Calling i1.set(6144).");

i1.set(6144);

}

private static void bindAndUnbindOnePropertyToAnother() {

System.out.println();

IntegerProperty i2 = new SimpleIntegerProperty(0);