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

См. также:

Binding, StringExpression

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

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

StringBinding()

Конструкторы
Конструктор	Описание
`StringBinding()`

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

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

Подробное описание конструкторов
- StringBinding
```
public 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.

Класс StringBinding

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

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

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

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

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

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

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

addListener

removeListener

addListener

removeListener

bind

unbind

dispose

getDependencies

get

onInvalidating

invalidate

isValid

computeValue

toString