Класс ListBinding<E>

java.lang.Object

javafx.beans.binding.ListExpression<E>

javafx.beans.binding.ListBinding<E>

Type Parameters:: E - тип элемента List

Все реализованные интерфейсы:: Iterable<E>, Collection<E>, List<E>, Binding<ObservableList<E>>, Observable, ObservableListValue<E>, ObservableObjectValue<ObservableList<E>>, ObservableValue<ObservableList<E>>, ObservableList<E>

public abstract class ListBinding<E> extends ListExpression<E> implements Binding<ObservableList<E>>

Базовый класс, предоставляющий большую часть функциональности, необходимой для реализации Binding для ObservableList.

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

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

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

С момента:

JavaFX 2.1

См. также:

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

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

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

Конструктор	Описание
`ListBinding()`	Создает по умолчанию `ListBinding`.

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

Модификатор и тип	Метод	Описание
`void`	`addListener(InvalidationListener listener)`	Добавляет `InvalidationListener`, который будет уведомлен всякий раз, когда `Observable` становится недействительным.
`void`	`addListener(ChangeListener<? super ObservableList<E>> listener)`	Добавляет `ChangeListener`, который будет уведомлен всякий раз, когда изменяется значение `ObservableValue`.
`void`	`addListener(ListChangeListener<? super E> listener)`	Добавляет слушатель в этот наблюдаемый список.
`protected final void`	`bind(Observable... dependencies)`	Начать наблюдение за изменениями зависимостей.
`protected abstract ObservableList<E>`	`computeValue()`	Вычисляет текущее значение этого связывания.
`void`	`dispose()`	Реализация по умолчанию для `dispose()`, которая возвращает пустое значение.
`ReadOnlyBooleanProperty`	`emptyProperty()`	Свойство типа boolean, которое равно `true`, если список пуст.
`final ObservableList<E>`	`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 ObservableList<E>> listener)`	Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение `ObservableValue` изменяется.
`void`	`removeListener(ListChangeListener<? super E> listener)`	Попытка удалить слушателя из этого наблюдаемого списка.
`ReadOnlyIntegerProperty`	`sizeProperty()`	Свойство типа integer, представляющее размер списка.
`String`	`toString()`	Возвращает строковое представление этого объекта `ListBinding`.
`protected final void`	`unbind(Observable... dependencies)`	Прекратить наблюдение за изменениями зависимостей.

Методы, объявленные в классе javafx.beans.binding.ListExpression

add, add, addAll, addAll, addAll, asString, clear, contains, containsAll, get, getSize, getValue, indexOf, isEmpty, isEqualTo, isNotEqualTo, isNotNull, isNull, iterator, lastIndexOf, listExpression, listIterator, listIterator, remove, remove, remove, removeAll, removeAll, retainAll, retainAll, set, setAll, setAll, size, subList, toArray, toArray, valueAt, valueAt

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.util.Collection

parallelStream, removeIf, stream, toArray

Методы, объявленные в интерфейсе java.lang.Iterable

forEach

Методы, объявленные в интерфейсе java.util.List

equals, hashCode, replaceAll, sort, spliterator

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

subscribe

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

filtered, sorted, sorted

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

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

Подробности полей

size

public ReadOnlyIntegerProperty sizeProperty

Указано в:

sizeProperty in class ListExpression<E>

Возвращает:

the property

См. также:

sizeProperty()

empty

public ReadOnlyBooleanProperty emptyProperty

Указано в:

emptyProperty in class ListExpression<E>

Возвращает:

the ReadOnlyBooleanProperty

См. также:

emptyProperty()

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

ListBinding

public ListBinding()

Создает ListBinding по умолчанию.

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

sizeProperty

public ReadOnlyIntegerProperty sizeProperty()

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

Integer property that represents the size of the list.

Указано в:: sizeProperty in class ListExpression<E>
Возвращает:: the size property

emptyProperty

public ReadOnlyBooleanProperty emptyProperty()

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

A boolean property that is true, if the list is empty.

Указано в:: emptyProperty in class ListExpression<E>
Возвращает:: the empty property

addListener

public void addListener(InvalidationListener listener)

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

Добавляет InvalidationListener, который будет уведомлен всякий раз, когда Observable становится недействительным. Если один и тот же слушатель добавлен более одного раза, он будет уведомлен более одного раза. То есть проверка на уникальность не выполняется.

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

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

Указано в:

addListener in interface Observable

Параметры:

listener - The listener to register

См. также:

Observable.removeListener(InvalidationListener)

removeListener

public void removeListener(InvalidationListener listener)

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

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

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

Указано в:

removeListener in interface Observable

Параметры:

listener - The listener to remove

См. также:

Observable.addListener(InvalidationListener)

addListener

public void addListener(ChangeListener<? super ObservableList<E>> listener)

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

Добавляет ChangeListener, который будет уведомлен всякий раз, когда значение ObservableValue изменится. Если один и тот же слушатель добавлен более одного раза, он будет уведомлен более одного раза. То есть проверка на уникальность не выполняется.

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

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

Указано в:

addListener in interface ObservableValue<E>

Параметры:

listener - The listener to register

См. также:

ObservableValue.removeListener(ChangeListener)

removeListener

public void removeListener(ChangeListener<? super ObservableList<E>> listener)

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

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

Указано в:

removeListener in interface ObservableValue<E>

Параметры:

listener - The listener to remove

См. также:

ObservableValue.addListener(ChangeListener)

addListener

public void addListener(ListChangeListener<? super E> listener)

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

Добавить слушателя к этому наблюдаемому списку.

Указано в:: addListener in interface ObservableList<E>
Параметры:: listener - the listener for listening to the list changes

removeListener

public void removeListener(ListChangeListener<? super E> listener)

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

Пытается удалить слушателя из этого наблюдаемого списка. Если слушатель не прикреплен к этому списку, ничего не происходит.

Указано в:: removeListener in interface ObservableList<E>
Параметры:: 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 in interface Binding<E>

getDependencies

public ObservableList<?> getDependencies()

Стандартная реализация getDependencies(), которая возвращает пустой ObservableList.

Указано в:: getDependencies in interface Binding<E>
Возвращает:: an empty ObservableList

get

public final ObservableList<E> get()

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

Указано в:: get in interface ObservableObjectValue<E>
Возвращает:: the current value

onInvalidating

protected void onInvalidating()

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

invalidate

public final void invalidate()

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

Пометьте привязку как недействительную. Это заставляет пересчитывать значение Binding при следующем запросе.

Указано в:: invalidate in interface Binding<E>

isValid

public final boolean isValid()

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

Проверяет, является ли привязка валидной.

Определено в:: isValid в интерфейсе Binding<E>
Возвращает:: true, если Binding валидна, false в противном случае

computeValue

protected abstract ObservableList<E> computeValue()

Вычисляет текущее значение этой привязки.

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

Возвращает:: текущее значение

toString

public String toString()

Возвращает строковое представление этого объекта ListBinding.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого объекта ListBinding.

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