Класс ObjectBinding<T>

java.lang.Object

javafx.beans.binding.ObjectExpression<T>

javafx.beans.binding.ObjectBinding<T>

Параметры типа:: T - тип оборачиваемого Object

Все реализованные интерфейсы:: Binding<T>, Observable, ObservableObjectValue<T>, ObservableValue<T>

public abstract class ObjectBinding<T> extends ObjectExpression<T> implements Binding<T>

Базовый класс, предоставляющий большую часть функциональности, необходимой для реализации Binding для Object.

ObjectBinding предоставляет простую схему обновления. Расширяющий класс может регистрировать зависимости, вызывая bind(Observable...). Если одна из зарегистрированных зависимостей становится недействительной, этот ObjectBinding помечается как недействительный. С помощью unbind(Observable...) прослушивание зависимостей можно остановить.

Для предоставления конкретной реализации этого класса необходимо реализовать метод computeValue() для вычисления значения этого привязывания на основе текущего состояния зависимостей. Он вызывается при вызове get() для недействительного привязывания.

См. DoubleBinding для примера расширения этого базового класса.

С тех пор:

JavaFX 2.0

См. также:

Краткое описание конструкторов

Конструктор	Описание
`ObjectBinding()`	Создаёт стандартный `ObjectBinding`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addListener(InvalidationListener listener)`	Добавляет `InvalidationListener`, который будет уведомляться всякий раз, когда `Observable` становится недействительным.
`void`	`addListener(ChangeListener<? super T> listener)`	Добавляет `ChangeListener`, который будет уведомляться всякий раз, когда значение `ObservableValue` изменяется.
`protected boolean`	`allowValidation()`	Проверяет, разрешено ли привязыванию стать действительным.
`protected final void`	`bind(Observable... dependencies)`	Начать наблюдение за зависимостями на предмет изменений.
`protected abstract T`	`computeValue()`	Вычисляет текущее значение этого привязывания.
`void`	`dispose()`	Стандартная пустая реализация `dispose()`.
`final T`	`get()`	Возвращает результат `computeValue()`.
`ObservableList<?>`	`getDependencies()`	Стандартная реализация `getDependencies()`, возвращающая пустой `ObservableList`.
`final void`	`invalidate()`	Помечает привязывание как недействительное.
`protected final boolean`	`isObserved()`	Проверяет, зарегистрирован ли по крайней мере один слушатель на привязывании.
`final boolean`	`isValid()`	Проверяет, является ли привязывание действительным.
`protected void`	`onInvalidating()`	Вызывается, когда это привязывание становится недействительным.
`void`	`removeListener(InvalidationListener listener)`	Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение `Observable` становится недействительным.
`void`	`removeListener(ChangeListener<? super T> listener)`	Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение `ObservableValue` изменяется.
`String`	`toString()`	Возвращает строковое представление этого объекта `ObjectBinding`.
`protected final void`	`unbind(Observable... dependencies)`	Остановить наблюдение за зависимостями на предмет изменений.

Методы, объявленные в классе javafx.beans.binding.ObjectExpression

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

Методы, объявленные в классе java.lang.Object

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

Методы, объявленные в интерфейсе javafx.beans.Observable

subscribe

Методы, объявленные в интерфейсе javafx.beans.value.ObservableValue

flatMap, getValue, map, orElse, subscribe, subscribe, when

Подробное описание конструкторов

ObjectBinding

public ObjectBinding()

Создаёт стандартную ObjectBinding.

Подробное описание методов

addListener

public void addListener(InvalidationListener listener)

Описание скопировано из интерфейса: Observable

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

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

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

Определено:

addListener в интерфейсе Observable

Параметры:

listener - Слушатель для регистрации

См. также:

Observable.removeListener(InvalidationListener)

removeListener

public void removeListener(InvalidationListener listener)

Описание скопировано из интерфейса: Observable

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

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

Определено:

removeListener в интерфейсе Observable

Параметры:

listener - Слушатель для удаления

См. также:

Observable.addListener(InvalidationListener)

addListener

public void addListener(ChangeListener<? super T> listener)

Описание скопировано из интерфейса: ObservableValue

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

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

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

Определено:

addListener в интерфейсе ObservableValue<T>

Параметры:

listener - Слушатель для регистрации

См. также:

ObservableValue.removeListener(ChangeListener)

removeListener

public void removeListener(ChangeListener<? super T> listener)

Описание скопировано из интерфейса: ObservableValue

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

Определено:

removeListener в интерфейсе ObservableValue<T>

Параметры:

listener - Слушатель для удаления

См. также:

ObservableValue.addListener(ChangeListener)

bind

protected final void bind(Observable... dependencies)

Начинает наблюдение за зависимостями на изменения. Если значение одной из зависимостей изменится, привязка помечается как недействительная.

Параметры:: dependencies - зависимость для наблюдения

unbind

protected final void unbind(Observable... dependencies)

Прекращает наблюдение за зависимостями на изменения.

Параметры:: dependencies - зависимость для прекращения наблюдения

dispose

public void dispose()

Стандартная реализация dispose(), которая пуста.

Определено:: dispose в интерфейсе Binding<T>

getDependencies

public ObservableList<?> getDependencies()

Стандартная реализация getDependencies(), которая возвращает пустой ObservableList.

Определено:: getDependencies в интерфейсе Binding<T>
Возвращает:: пустой ObservableList

get

public final T get()

Возвращает результат computeValue(). Метод computeValue() вызывается только в том случае, если привязка недействительна. Результат кэшируется и возвращается, если привязка не стала недействительной с момента последнего вызова get().

Определено:: get в интерфейсе ObservableObjectValue<T>
Возвращает:: текущее значение

onInvalidating

protected void onInvalidating()

Вызывается, когда эта привязка становится недействительной. Может быть переопределён подклассами для реакции на аннулирование. Стандартная реализация пуста.

invalidate

public final void invalidate()

Описание скопировано из интерфейса: Binding

Помечает привязку как недействительную. Это заставляет пересчитать значение Binding в следующий раз, когда оно запросится.

Определено:: invalidate в интерфейсе Binding<T>

isValid

public final boolean isValid()

Описание скопировано из интерфейса: Binding

Проверяет, является ли привязка действительной.

Определено:: isValid в интерфейсе Binding<T>
Возвращает:: true, если Binding действительна, false в противном случае

isObserved

protected final boolean isObserved()

Проверяет, есть ли у привязки хотя бы один зарегистрированный слушатель. Это полезно для подклассов, которые хотят сохранить ресурсы, когда не наблюдаются.

Возвращает:: true, если у этой привязки в настоящее время зарегистрирован один или несколько слушателей, в противном случае false
С:: 19

allowValidation

protected boolean allowValidation()

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

Стандартная реализация всегда разрешает привязкам стать действительными.

Возвращает:: true, если эта привязка разрешена для перехода в действительное состояние, в противном случае false
С:: 19

computeValue

protected abstract T computeValue()

Вычисляет текущее значение этой привязки.

Классы, расширяющие ObjectBinding, должны предоставить реализацию computeValue.

Возвращает:: текущее значение

toString

public String toString()

Возвращает строковое представление этого объекта ObjectBinding.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого объекта ObjectBinding.

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.