Класс StringBinding
- 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()
-
Краткое описание методов
Все методыМетоды экземпляраАбстрактные методыКонкретные методы Модификатор и тип Метод и описание voidaddListener(ChangeListener<? super String> listener)ДобавляетChangeListener, который будет уведомляться всякий раз, когда значениеObservableValueизменяется.voidaddListener(InvalidationListener listener)ДобавляетInvalidationListener, который будет уведомляться всякий раз, когдаObservableстановится недействительным.protected voidbind(Observable... dependencies)Начинает наблюдать за изменениями зависимостей.protected abstract StringcomputeValue()Вычисляет текущее значение этого привязывания.voiddispose()Стандартная реализацияdispose(), которая пуста.Stringget()Возвращает результатcomputeValue().ObservableList<?>getDependencies()Стандартная реализацияgetDependencies(), которая возвращает пустойObservableList.voidinvalidate()Помечает привязывание как недействительное.booleanisValid()Проверяет, является ли привязывание действительным.protected voidonInvalidating()Метод onInvalidating() может быть переопределен расширяемыми классами для реакции, если это привязывание станет недействительным.voidremoveListener(ChangeListener<? super String> listener)Удаляет заданный слушатель из списка слушателей, которые уведомляются всякий раз, когда значениеObservableValueизменяется.voidremoveListener(InvalidationListener listener)Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableстановится недействительным.StringtoString()Возвращает строковое представление этогоStringBindingобъекта.protected voidunbind(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- Слушатель для регистрации
-
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(), которая пуста.
-
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Проверяет, является ли связывание действительным.
-
computeValue
protected abstract String computeValue()
Вычисляет текущее значение этого связывания.Классы, расширяющие
StringBinding, должны предоставить реализациюcomputeValue.Возвращает:
текущее значение
-
toString
public String toString()
Возвращает строковое представление этого объекта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.