Класс 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 - Слушатель для регистрации

См. также:

removeListener

public void removeListener(InvalidationListener listener)

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

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

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

Указано:

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

Параметры:

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

См. также:

addListener

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

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

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

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

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

Указано:

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

Параметры:

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

См. также:

removeListener

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

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

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

Указано:

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

Параметры:

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

См. также:

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.