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

Класс MapBinding<K,V>

java.lang.Object
  • javafx.beans.binding.MapExpression<K,V>
    • javafx.beans.binding.MapBinding<K,V>

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

K - тип элементов ключей

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

Map<K,V>, Binding<ObservableMap<K,V>>, Observable, ObservableMapValue<K,V>, ObservableObjectValue<ObservableMap<K,V>>, ObservableValue<ObservableMap<K,V>>, ObservableMap<K,V>



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

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

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

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

С момента:

JavaFX 2.1

См. также:

Binding, MapExpression

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

    Все методыМетоды экземпляровКонкретные методы
    Тип Свойство и описание
    ReadOnlyBooleanProperty empty
    Логическое свойство, которое равно true, если карта пуста.
    ReadOnlyIntegerProperty size
    Целочисленное свойство, представляющее размер карты.
  • Краткое описание вложенных классов

    • Вложенные классы/интерфейсы, унаследованные от интерфейса java.util.Map

      Map.Entry<K,V>
  • Краткое описание конструкторов

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

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

      asString, clear, containsKey, containsValue, entrySet, get, getSize, getValue, isEmpty, isEqualTo, isNotEqualTo, isNotNull, isNull, keySet, mapExpression, put, putAll, remove, size, valueAt, valueAt, values
    • Методы, унаследованные от класса java.lang.Object

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

      getValue
    • Методы, унаследованные от интерфейса java.util.Map

      compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll
  • Подробности свойства

    • размер

      public ReadOnlyIntegerProperty sizeProperty

      Указано:

      sizeProperty в классе MapExpression<K,V>

      Возвращает:

      свойство

    • пусто

      public ReadOnlyBooleanProperty emptyProperty

      Указано:

      emptyProperty в классе MapExpression<K,V>

  • Подробности конструктора

    • MapBinding

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

    • sizeProperty

      public ReadOnlyIntegerProperty sizeProperty()
      Описание скопировано из класса: MapExpression
      Целочисленное свойство, представляющее размер карты.

      Указано:

      sizeProperty в классе MapExpression<K,V>

      Возвращает:

      свойство

    • emptyProperty

      public ReadOnlyBooleanProperty emptyProperty()
      Описание скопировано из класса: MapExpression
      Булево свойство, которое является true, если карта пуста.

      Указано:

      emptyProperty в классе MapExpression<K,V>

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

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

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

      Указано:

      addListener в интерфейсе ObservableValue<ObservableMap<K,V>>

      Параметры:

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

      См. также:

      ObservableValue.removeListener(ChangeListener)

    • removeListener

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

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

      Указано:

      removeListener в интерфейсе ObservableValue<ObservableMap<K,V>>

      Параметры:

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

      См. также:

      ObservableValue.addListener(ChangeListener)

    • addListener

      public void addListener(MapChangeListener<? super K,? super V> listener)
      Описание скопировано из интерфейса: ObservableMap
      Добавить слушателя к этой наблюдаемой карте.

      Указано:

      addListener в интерфейсе ObservableMap<K,V>

      Параметры:

      listener - слушатель для прослушивания изменений списка

    • removeListener

      public void removeListener(MapChangeListener<? super K,? super V> listener)
      Описание скопировано из интерфейса: ObservableMap
      Попытка удалить слушателя из этого наблюдаемого списка. Если слушатель не присоединён к этому списку, ничего не происходит.

      Указано:

      removeListener в интерфейсе ObservableMap<K,V>

      Параметры:

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

    • bind

      protected final void bind(Observable... dependencies)
      Начать наблюдение за зависимостями на предмет изменений. Если значение одной из зависимостей изменяется, привязка отмечается как недействительная.

      Параметры:

      dependencies - зависимости для наблюдения

    • unbind

      protected final void unbind(Observable... dependencies)
      Прекратить наблюдение за зависимостями на предмет изменений.

      Параметры:

      dependencies - зависимости для прекращения наблюдения

    • dispose

      public void dispose()
      Реализация по умолчанию dispose(), которая пуста.

      Указано:

      dispose в интерфейсе Binding<ObservableMap<K,V>>

    • getDependencies

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

      Указано:

      getDependencies в интерфейсе Binding<ObservableMap<K,V>>

      Возвращает:

      пустой ObservableList

    • get

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

      Указано:

      get в интерфейсе ObservableObjectValue<ObservableMap<K,V>>

      Возвращает:

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

    • onInvalidating

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

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

      Указано:

      invalidate в интерфейсе Binding<ObservableMap<K,V>>

    • isValid

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

      Указано:

      isValid в интерфейсе Binding<ObservableMap<K,V>>

      Возвращает:

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

    • computeValue

      protected abstract ObservableMap<K,V> computeValue()
      Вычисляет текущее значение этой привязки.

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

      Возвращает:

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

    • toString

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

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

      toString в классе Object

      Возвращает:

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

© 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