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

Класс ObjectBinding<T>

java.lang.Object
  • javafx.beans.binding.ObjectExpression<T>
    • javafx.beans.binding.ObjectBinding<T>

Параметры типа:

T - тип оборачиваемого Object

Все реализуемые интерфейсы:

Binding<T>, Observable, ObservableObjectValue<T>, ObservableValue<T>



public abstract class ObjectBinding<T>
extends ObjectExpression<T>
implements Binding<T>
Базовый класс, предоставляющий большую часть функциональности, необходимой для реализации привязки Binding к Object.

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

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

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

С момента:

JavaFX 2.0

См. также:

Binding, ObjectExpression

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

    Конструкторы
    Конструктор и описание
    ObjectBinding()
  • Краткое описание методов

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

      asString, asString, asString, getValue, isEqualTo, isEqualTo, isNotEqualTo, isNotEqualTo, isNotNull, isNull, objectExpression
    • Наследованные методы из класса java.lang.Object

      clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Наследованные методы из интерфейса javafx.beans.value.ObservableValue

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

    • ObjectBinding

      public ObjectBinding()
  • Подробное описание методов

    • 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 T> listener)
      Описание скопировано из интерфейса: ObservableValue
      Добавляет ChangeListener, который будет уведомлен всякий раз, когда значение ObservableValue изменяется. Если один и тот же слушатель добавляется более одного раза, он будет уведомлён более одного раза. То есть, проверка уникальности не производится.

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

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

      Определено в:

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

      Параметры:

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

      См. также:

      ObservableValue.removeListener(ChangeListener)

    • removeListener

      public void removeListener(ChangeListener<? super T> listener)
      Описание скопировано из интерфейса: ObservableValue
      Удаляет указанного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение ObservableValue изменяется.

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

      Определено в:

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

      Параметры:

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

    • getDependencies

      public ObservableList<?> getDependencies()
      Реализация по умолчанию getDependencies(), которая возвращает пустой ObservableList.

      Определено в:

      getDependencies в интерфейсе Binding<T>

      Возвращает:

      пустой ObservableList

    • get

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

      Определено в:

      get в интерфейсе ObservableObjectValue<T>

      Возвращает:

      текущее значение

    • onInvalidating

      protected void onInvalidating()
      Метод onInvalidating() может быть переопределён расширяющими классами для реакции, если эта привязка становится недействительной. Реализация по умолчанию пуста.
    • invalidate

      public final void invalidate()
      Описание скопировано из интерфейса: Binding
      Отмечает привязку как недействительную. Это принуждает к перерасчёту значения Binding при следующем запросе.

      Определено в:

      invalidate в интерфейсе Binding<T>

    • isValid

      public final boolean isValid()
      Описание скопировано из интерфейса: Binding
      Проверяет, является ли привязка действительной.

      Определено в:

      isValid в интерфейсе Binding<T>

      Возвращает:

      true, если Binding действительная, false в противном случае

    • computeValue

      protected abstract T computeValue()
      Вычисляет текущее значение этой привязки.

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

      Возвращает:

      текущее значение

    • toString

      public String toString()
      Возвращает строковое представление этого объекта ObjectBinding.

      Переопределяет:

      toString в классе Object

      Возвращает:

      строковое представление этого объекта ObjectBinding.

© 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