Интерфейс ObservableValue<T>

void addListener(ChangeListener<? super T> listener)

Добавляет ChangeListener, который будет уведомляться всякий раз, когда значение ObservableValue изменится. Если один и тот же слушатель добавляется более одного раза, он будет уведомляться более одного раза. То есть, проверка уникальности не выполняется.

Обратите внимание, что один и тот же фактический экземпляр ChangeListener может быть безопасно зарегистрирован для разных ObservableValues.

ObservableValue хранит сильную ссылку на слушателя, что предотвратит сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвав removeListener после использования, либо использовать экземпляр WeakChangeListener, чтобы избежать этой ситуации.

void removeListener(ChangeListener<? super T> listener)

Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение ObservableValue изменяется.

Если заданный слушатель ранее не был зарегистрирован (т. е. он никогда не добавлялся), то вызов этого метода является пустой операцией. Если он был ранее добавлен, он будет удален. Если он был добавлен более одного раза, то будет удалена только первая запись.

T getValue()

Возвращает текущее значение этого ObservableValue

default <U> ObservableValue<U> map(Function<? super T,? extends U> mapper)

Возвращает ObservableValue, содержащий результат применения заданной функции отображения к этому значению. Результат обновляется при изменении этого ObservableValue. Если это значение null, отображение не применяется, и возвращаемое значение также null.

Например, отображение строки в строку в верхнем регистре:

 var text = new SimpleStringProperty("abcd");
 ObservableValue<String> upperCase = text.map(String::toUpperCase);

 upperCase.getValue();  // Returns "ABCD"
 text.set("xyz");
 upperCase.getValue();  // Returns "XYZ"
 text.set(null);
 upperCase.getValue();  // Returns null
 

default ObservableValue<T> orElse(T constant)

Возвращает ObservableValue, содержащий это значение, или заданную константу, если оно null. Результат обновляется при изменении этого ObservableValue. Этот метод, в сочетании с map(Function), позволяет обрабатывать все значения, включая null значения.

Например, отображение строки в строку в верхнем регистре, но оставляя пустым, если вход null:

 var text = new SimpleStringProperty("abcd");
 ObservableValue<String> upperCase = text.map(String::toUpperCase).orElse("");

 upperCase.getValue();  // Returns "ABCD"
 text.set(null);
 upperCase.getValue();  // Returns ""
 

default <U> ObservableValue<U> flatMap(Function<? super T,? extends ObservableValue<? extends U>> mapper)

Возвращает ObservableValue, содержащий значение ObservableValue, полученное путём применения заданной функции отображения к этому значению. Результат обновляется при изменении либо этого ObservableValue, либо ObservableValue, полученного отображением. Если это значение null, отображение не применяется, и возвращаемое значение равно null. Если отображение привело к null, то возвращаемое значение также null.

Этот метод похож на map(Function), но функция отображения возвращает уже существующее ObservableValue, и, если вызывается, flatMap не оборачивает его в дополнительное ObservableValue.

Например, свойство, которое является true только тогда, когда элемент пользовательского интерфейса является частью Scene, которая является частью Window, которая в настоящее время отображается на экране:

 ObservableValue<Boolean> isShowing = listView.sceneProperty()
     .flatMap(Scene::windowProperty)
     .flatMap(Window::showingProperty)
     .orElse(false);

 // Assuming the listView is currently shown to the user, then:

 isShowing.getValue();  // Returns true

 listView.getScene().getWindow().hide();
 isShowing.getValue();  // Returns false

 listView.getScene().getWindow().show();
 isShowing.getValue();  // Returns true

 listView.getParent().getChildren().remove(listView);
 isShowing.getValue();  // Returns false
 

Изменения в любом из значений: сцены listView, окна этой сцены или отображения этого окна, обновят булево значение isShowing.

Этот метод предпочтительнее методов Bindings, так как он является безопасным с точки зрения типов.

default ObservableValue<T> when(ObservableValue<Boolean> condition)

Возвращает ObservableValue, содержащий это значение и обновляемый только тогда, когда condition содержит true.

Возвращаемое ObservableValue наблюдает за этим значением только тогда, когда condition содержит true. Это позволяет этому ObservableValue и условному ObservableValue быть собраны сборщиком мусора, если ни один из них не ссылается иначе, когда condition содержит false. Это в отличие от общего поведения связей, где связь может быть собрана сборщиком мусора только тогда, когда она сама не наблюдается.

condition, содержащий null, обрабатывается как содержащий false.

Например:

 ObservableValue<Boolean> condition = new SimpleBooleanProperty(true);
 ObservableValue<String> longLivedProperty = new SimpleStringProperty("A");
 ObservableValue<String> whenProperty = longLivedProperty.when(condition);

 // observe whenProperty, which will in turn observe longLivedProperty
 whenProperty.addListener((ov, old, current) -> System.out.println(current));

 longLivedProperty.setValue("B");  // "B" is printed

 condition.setValue(false);

 // After condition becomes false, whenProperty stops observing longLivedProperty; condition
 // and whenProperty may now be eligible for GC despite being observed by the ChangeListener

 longLivedProperty.setValue("C");  // nothing is printed
 longLivedProperty.setValue("D");  // nothing is printed

 condition.setValue(true);  // longLivedProperty is observed again, and "D" is printed
 

default Subscription subscribe(BiConsumer<? super T,? super T> changeSubscriber)

Создаёт Subscription на этом ObservableValue, который вызывает заданный changeSubscriber со старым и новым значениями всякий раз, когда его значение меняется. Предоставленный подписчик аналогичен ChangeListener без параметра ObservableValue.

Параметры, предоставленные BiConsumer, — это старое и новое значения соответственно.

Обратите внимание, что один и тот же экземпляр подписчика может безопасно подписываться на разные Observables.

Также обратите внимание, что при подписке на Observable с более длительным жизненным циклом, чем у подписчика, подписчик должен быть отписан, когда больше не нужен, так как подписка в противном случае не позволит подписчику быть собранным сборщиком мусора. Рассмотрите возможность создания производного ObservableValue с помощью when(ObservableValue) и подписку на это производное наблюдаемое значение, чтобы автоматически отсоединить жизненный цикл подписчика от этого ObservableValue, когда какое-либо условие выполняется.

default Subscription subscribe(Consumer<? super T> valueSubscriber)

Создаёт подписку на это ObservableValue, которая сразу же предоставляет текущее значение заданному valueSubscriber, а затем любые последующие значения всякий раз, когда его значение изменяется. valueSubscriber вызывается сразу же для удобства, так как обычно пользователь захочет инициализировать значение, а затем обновлять его при изменениях.

Обратите внимание, что один и тот же экземпляр подписчика может безопасно подписываться на различные Observables.

Также обратите внимание, что при подписке на Observable с более длительным жизненным циклом, чем у подписчика, подписчик должен быть отписан, когда он больше не нужен, так как в противном случае подписка помешает подписчику быть удалённым сборщиком мусора. Рассмотрите возможность создания производного ObservableValue с помощью when(ObservableValue) и подписки на это производное наблюдаемое значение, чтобы автоматически отвязать жизненный цикл подписчика от этого ObservableValue, когда выполняется некоторое условие.