Класс MapBinding<K,V>

java.lang.Object

javafx.beans.binding.MapExpression<K,V>

javafx.beans.binding.MapBinding<K,V>

Type Parameters:: 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

См. также:

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

Тип	Свойство	Описание
`ReadOnlyBooleanProperty`	`empty`	Логическое свойство, которое равно `true`, если карта пуста.
`ReadOnlyIntegerProperty`	`size`	Целочисленное свойство, представляющее размер карты.

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.Map

Map.Entry<K,V>

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

Конструктор	Описание
`MapBinding()`	Создаёт стандартный `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 final void`	`bind(Observable... dependencies)`	Начать наблюдение за изменениями зависимостей.
`protected abstract ObservableMap<K,V>`	`computeValue()`	Вычисляет текущее значение этого привязывания.
`void`	`dispose()`	Стандартная реализация `dispose()`, которая пуста.
`ReadOnlyBooleanProperty`	`emptyProperty()`	Логическое свойство, которое равно `true`, если карта пуста.
`final ObservableMap<K,V>`	`get()`	Возвращает результат `computeValue()`.
`ObservableList<?>`	`getDependencies()`	Стандартная реализация `getDependencies()`, которая возвращает пустой `ObservableList`.
`final void`	`invalidate()`	Пометить привязывание как недействительное.
`final 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 final 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.Observable

subscribe

Методы, объявленные в интерфейсе javafx.beans.value.ObservableValue

flatMap, getValue, map, orElse, subscribe, subscribe, when

Подробности свойств

size

public ReadOnlyIntegerProperty sizeProperty

Определяется:

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

Возвращает:

свойство

См. также:

sizeProperty()

empty

public ReadOnlyBooleanProperty emptyProperty

Определяется:

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

Возвращает:

ReadOnlyBooleanProperty

См. также:

emptyProperty()

Подробности конструкторов

MapBinding

public MapBinding()

Создаёт стандартную MapBinding.

Подробности методов

sizeProperty

public ReadOnlyIntegerProperty sizeProperty()

Описание скопировано из класса: MapExpression

Целочисленное свойство, представляющее размер карты.

Определяется:: sizeProperty в классе MapExpression<K,V>
Возвращает:: свойство size

emptyProperty

public ReadOnlyBooleanProperty emptyProperty()

Описание скопировано из класса: MapExpression

Логическое свойство, которое равно true, если карта пуста.

Определяется:: emptyProperty в классе MapExpression<K,V>
Возвращает:: свойство empty

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

Параметры:

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

См. также:

ObservableValue.removeListener(ChangeListener)

removeListener

public void removeListener(ChangeListener<? super ObservableMap<K,V>> listener)

Описание скопировано из интерфейса: ObservableValue

Удаляет указанного слушателя из списка слушателей, которые уведомляются при изменении значения ObservableValue.

Определяется:

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

Параметры:

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