Класс MapBinding<K,V>
- 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
См. также:
-
Краткое описание свойств
Все методыМетоды экземпляровКонкретные методы Тип Свойство и описание ReadOnlyBooleanPropertyemptyЛогическое свойство, которое равноtrue, если карта пуста.ReadOnlyIntegerPropertysizeЦелочисленное свойство, представляющее размер карты.
-
Краткое описание вложенных классов
-
Краткое описание конструкторов
Конструкторы Конструктор и описание MapBinding()
-
Краткое описание методов
Все методыМетоды экземпляровАбстрактные методыКонкретные методы Модификатор и тип Метод и описание voidaddListener(ChangeListener<? super ObservableMap<K,V>> listener)ДобавляетChangeListener, который будет уведомляться всякий раз, когда значениеObservableValueизменится.voidaddListener(InvalidationListener listener)ДобавляетInvalidationListener, который будет уведомляться всякий раз, когдаObservableстановится недействительным.voidaddListener(MapChangeListener<? super K,? super V> listener)Добавляет слушатель в эту наблюдаемую карту.protected voidbind(Observable... dependencies)Начать наблюдение за изменениями зависимостей.protected abstract ObservableMap<K,V>computeValue()Вычисляет текущее значение этого связывания.voiddispose()Стандартная реализацияdispose(), которая пуста.ReadOnlyBooleanPropertyemptyProperty()Логическое свойство, которое равноtrue, если карта пуста.ObservableMap<K,V>get()Возвращает результатcomputeValue().ObservableList<?>getDependencies()Стандартная реализацияgetDependencies(), которая возвращает пустойObservableList.voidinvalidate()Пометить связывание как недействительное.booleanisValid()Проверяет, является ли связывание действительным.protected voidonInvalidating()Метод onInvalidating() может быть переопределен в расширяемых классах для реакции, если это связывание становится недействительным.voidremoveListener(ChangeListener<? super ObservableMap<K,V>> listener)Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableValueизменяется.voidremoveListener(InvalidationListener listener)Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableстановится недействительным.voidremoveListener(MapChangeListener<? super K,? super V> listener)Попытка удалить слушателя из этого наблюдаемого списка.ReadOnlyIntegerPropertysizeProperty()Целочисленное свойство, представляющее размер карты.StringtoString()Возвращает строковое представление этогоMapBindingобъекта.protected voidunbind(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- Слушатель для регистрации
-
removeListener
public void removeListener(InvalidationListener listener)
Описание скопировано из интерфейса:ObservableУдаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableстановится недействительным.Если заданный слушатель ранее не был зарегистрирован (т. е. его никогда не добавляли), то этот вызов метода является бездействием. Если он был ранее добавлен, то он будет удален. Если он был добавлен более одного раза, то будет удален только первый экземпляр.
Указано:
removeListenerв интерфейсеObservableПараметры:
listener- Слушатель для удаленияСм. также:
-
addListener
public void addListener(ChangeListener<? super ObservableMap<K,V>> listener)
Описание скопировано из интерфейса:ObservableValueДобавляетChangeListener, который будет уведомляться всякий раз, когда значениеObservableValueменяется. Если один и тот же слушатель добавляется более одного раза, он будет уведомляться более одного раза. То есть проверка уникальности не выполняется.Обратите внимание, что один и тот же фактический экземпляр
ChangeListenerможет быть безопасно зарегистрирован для различныхObservableValues.ObservableValueхранит сильную ссылку на слушателя, что предотвратит сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвавremoveListenerпосле использования, либо использовать экземплярWeakChangeListener, чтобы избежать этой ситуации.Указано:
addListenerв интерфейсеObservableValue<ObservableMap<K,V>>Параметры:
listener- Слушатель для регистрации
-
removeListener
public void removeListener(ChangeListener<? super ObservableMap<K,V>> listener)
Описание скопировано из интерфейса:ObservableValueУдаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableValueизменяется.Если заданный слушатель ранее не был зарегистрирован (т. е. его никогда не добавляли), то этот вызов метода является бездействием. Если он был ранее добавлен, то он будет удален. Если он был добавлен более одного раза, то будет удален только первый экземпляр.
Указано:
removeListenerв интерфейсеObservableValue<ObservableMap<K,V>>Параметры:
listener- Слушатель для удаленияСм. также:
-
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.
-
© 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.