Spec-Zone.ru › OpenJavaFX 8
javafx.beans.binding

Класс 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()
  • Краткое описание методов

    Все методыМетоды экземпляраАбстрактные методыКонкретные методы
    Модификатор и тип Метод и описание
    void addListener(ChangeListener<? super String> listener)
    Добавляет ChangeListener, который будет уведомляться всякий раз, когда значение ObservableValue изменяется.
    void addListener(InvalidationListener listener)
    Добавляет InvalidationListener, который будет уведомляться всякий раз, когда Observable становится недействительным.
    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(ChangeListener<? super String> listener)
    Удаляет заданный слушатель из списка слушателей, которые уведомляются всякий раз, когда значение ObservableValue изменяется.
    void removeListener(InvalidationListener listener)
    Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение Observable становится недействительным.
    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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API