Класс StringBinding

java.lang.Object

javafx.beans.binding.StringExpression

javafx.beans.binding.StringBinding

Все реализуемые интерфейсы:: Binding<String>, Observable, ObservableObjectValue<String>, ObservableStringValue, ObservableValue<String>

public abstract class StringBinding extends StringExpression implements Binding<String>

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

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

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

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

С:

JavaFX 2.0

См. также:

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

Конструктор	Описание
`StringBinding()`	Создаёт по умолчанию `StringBinding`.

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

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

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

concat, getValue, getValueSafe, greaterThan, greaterThan, greaterThanOrEqualTo, greaterThanOrEqualTo, isEmpty, isEqualTo, isEqualTo, isEqualToIgnoreCase, isEqualToIgnoreCase, isNotEmpty, isNotEqualTo, isNotEqualTo, isNotEqualToIgnoreCase, isNotEqualToIgnoreCase, isNotNull, isNull, length, lessThan, lessThan, lessThanOrEqualTo, lessThanOrEqualTo, stringExpression

Методы, объявленные в классе 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

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

StringBinding

public StringBinding()

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

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

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 String> listener)

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

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

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

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

Определено:

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

Параметры:

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

См. также:

ObservableValue.removeListener(ChangeListener)

removeListener

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

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

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

Определено:

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

Параметры:

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<String>

getDependencies

public ObservableList<?> getDependencies()

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

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

get

public final String get()

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

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

onInvalidating

protected void onInvalidating()

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

invalidate

public final void invalidate()

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

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

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

isValid

public final boolean isValid()

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

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

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

computeValue

protected abstract String computeValue()

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

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

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

toString

public String toString()

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

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

© 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.