Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.base
Пакет javafx.beans.binding

Класс MapBinding<K,​V>

  • java.lang.Object
    • javafx.beans.binding.MapExpression<K,​V>
      • javafx.beans.binding.MapBinding<K,​V>
  • Параметры типа:
    K - тип элементов ключей
    V - тип элементов значений
    Все реализованные интерфейсы:
    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 extends Object,​V extends Object>

  • Резюме конструкторов

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

  • Резюме методов

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

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

      compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

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

      getValue

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

    • size

      public ReadOnlyIntegerProperty sizeProperty
      Указано в:
      sizeProperty в классе MapExpression<K,​V>
      См. также:
      MapExpression.getSize()

    • empty

      public ReadOnlyBooleanProperty emptyProperty
      Указано в:
      emptyProperty в классе MapExpression<K,​V>
      См. также:
      MapExpression.isEmpty()

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

    • MapBinding

      public MapBinding()

  • Method Detail

    • sizeProperty

      public ReadOnlyIntegerProperty sizeProperty()
      Описание скопировано из класса: MapExpression
      Свойство типа integer, представляющее размер карты.
      Определено в:
      sizeProperty в классе MapExpression<K,​V>
      См. также:
      MapExpression.getSize()

    • emptyProperty

      public ReadOnlyBooleanProperty emptyProperty()
      Описание скопировано из класса: MapExpression
      Свойство типа boolean, которое true, если карта пуста.
      Определено в:
      emptyProperty в классе MapExpression<K,​V>
      См. также:
      MapExpression.isEmpty()

    • addListener

      public void addListener​(InvalidationListener listener)
      Описание скопировано из интерфейса: Observable
      Добавляет InvalidationListener, который будет уведомлен всякий раз, когда Observable становится недействительным. Если один и тот же слушатель добавлен более одного раза, он будет уведомлен более одного раза. То есть проверка на уникальность не выполняется.

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

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

      Определено в:
      addListener в интерфейсе Observable
      Параметры:
      listener - The listener to register
      См. также:
      Observable.removeListener(InvalidationListener)

    • removeListener

      public void removeListener​(InvalidationListener listener)
      Описание скопировано из интерфейса: Observable
      Удаляет данный слушатель из списка слушателей, которые уведомляются всякий раз, когда значение Observable становится недействительным.

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

      Определено в:
      removeListener в интерфейсе Observable
      Параметры:
      listener - The listener to remove
      См. также:
      Observable.addListener(InvalidationListener)

    • addListener

      public void addListener​(ChangeListener<? super ObservableMap<K,​V>> listener)
      Описание скопировано из интерфейса: ObservableValue
      Добавляет ChangeListener, который будет уведомлен всякий раз, когда значение ObservableValue изменяется. Если один и тот же слушатель добавлен более одного раза, он будет уведомлен более одного раза. То есть проверка на уникальность не выполняется.

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

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

      Определено в:
      addListener в интерфейсе ObservableValue<K>
      Параметры:
      listener - The listener to register
      См. также:
      ObservableValue.removeListener(ChangeListener)

    • removeListener

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

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

      Определено в:
      removeListener в интерфейсе ObservableValue<K>
      Параметры:
      listener - The listener to remove
      См. также:
      ObservableValue.addListener(ChangeListener)

    • addListener

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

    • removeListener

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

    • bind

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

    • unbind

      protected final void unbind​(Observable... dependencies)
      Прекратить наблюдение за зависимостями на предмет изменений.
      Параметры:
      dependencies - the dependencies to stop observing

    • dispose

      public void dispose()
      Реализация по умолчанию dispose(), которая пуста.
      Определено в:
      dispose в интерфейсе Binding<K>

    • getDependencies

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

    • get

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

    • onInvalidating

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

    • invalidate

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

    • isValid

      public final boolean isValid()
      Описание скопировано из интерфейса: Binding
      Проверяет, действительна ли привязка.
      Определено в:
      isValid в интерфейсе Binding<K>
      Возвращает:
      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