ListBinding

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 для примера расширения этого базового класса.

Since:

JavaFX 2.1

См. также:

Binding, ListExpression

Сводка свойств

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

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

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

ListBinding()

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

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

Все методыМетоды экземпляраАбстрактные методыКонкретные методы
Модификатор и тип	Метод	Описание
`void`	`addListener(InvalidationListener listener)`	Добавляет `InvalidationListener`, который будет уведомляться всякий раз, когда `Observable` становится недействительным.
`void`	`addListener(ChangeListener<? super ObservableList<E>> listener)`	Добавляет `ChangeListener`, который будет уведомляться всякий раз, когда значение `ObservableValue` меняется.
`void`	`addListener(ListChangeListener<? super E> listener)`	Добавляет слушателя в этот наблюдаемый список.
`protected void`	`bind(Observable... dependencies)`	Начать наблюдение за изменениями зависимостей.
`protected abstract ObservableList<E>`	`computeValue()`	Вычисляет текущее значение этого связывания.
`void`	`dispose()`	Стандартная реализация `dispose()`, которая пустая.
`ReadOnlyBooleanProperty`	`emptyProperty()`	Логическое свойство, которое равно `true`, если список пуст.
`ObservableList<E>`	`get()`	Возвращает результат `computeValue()`.
`ObservableList<?>`	`getDependencies()`	Стандартная реализация `getDependencies()`, которая возвращает пустой `ObservableList`.
`void`	`invalidate()`	Помечает связывание как недействительное.
`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()`	Целочисленное свойство, представляющее размер списка.
`String`	`toString()`	Возвращает строковое представление этого объекта `ListBinding`.
`protected 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.collections.ObservableList
filtered, sorted, sorted

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

Подробное описание свойств
- размер
```
public ReadOnlyIntegerProperty sizeProperty
```
  Определено:
  
  sizeProperty в классе ListExpression<E>
  
  См. также:
  
  ListExpression.getSize()
- пустой
```
public ReadOnlyBooleanProperty emptyProperty
```
  Определено:
  
  emptyProperty в классе ListExpression<E>
  
  См. также:
  
  ListExpression.isEmpty()

Подробное описание конструкторов
- ListBinding
```
public ListBinding()
```

Method Detail
- sizeProperty
```
public ReadOnlyIntegerProperty sizeProperty()
```
  Описание скопировано из класса: ListExpression
  
  Свойство типа integer, представляющее размер списка.
  
  Определено в:
  
  sizeProperty in class ListExpression<E>
  
  См. также:
  
  ListExpression.getSize()
- emptyProperty
```
public ReadOnlyBooleanProperty emptyProperty()
```
  Описание скопировано из класса: ListExpression
  
  Логическое свойство, которое имеет значение true, если список пуст.
  
  Определено в:
  
  emptyProperty in class ListExpression<E>
  
  См. также:
  
  ListExpression.isEmpty()
- addListener
```
public void addListener(InvalidationListener listener)
```
  Описание скопировано из интерфейса: Observable
  
  Добавляет InvalidationListener, который будет уведомлен всякий раз, когда Observable станет недействительным. Если один и тот же слушатель добавлен более одного раза, он будет уведомлен более одного раза. То есть проверка на уникальность не выполняется.
  Обратите внимание, что один и тот же экземпляр InvalidationListener может быть безопасно зарегистрирован для разных Observables.
  
  Observable хранит сильную ссылку на слушателя, что не позволит слушателю быть собранным сборщиком мусора и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвав removeListener после использования, либо использовать экземпляр WeakInvalidationListener, чтобы избежать этой ситуации.
  
  Определено в:
  
  addListener in interface Observable
  
  Параметры:
  
  listener - Слушатель для регистрации
  
  См. также:
  
  Observable.removeListener(InvalidationListener)
- removeListener
```
public void removeListener(InvalidationListener listener)
```
  Описание скопировано из интерфейса: Observable
  
  Удаляет данного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение Observable становится недействительным.
  Если данный слушатель ранее не был зарегистрирован (т. е. никогда не был добавлен), то этот вызов метода ничего не делает. Если он был добавлен ранее, то он будет удален. Если он был добавлен более одного раза, то будет удалено только первое вхождение.
  
  Определено в:
  
  removeListener in interface Observable
  
  Параметры:
  
  listener - Слушатель для удаления
  
  См. также:
  
  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 - Слушатель для регистрации
  
  См. также:
  
  ObservableValue.removeListener(ChangeListener)
- removeListener
```
public void removeListener(ChangeListener<? super ObservableList<E>> listener)
```
  Описание скопировано из интерфейса: ObservableValue
  
  Удаляет данного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение ObservableValue изменяется.
  Если данный слушатель ранее не был зарегистрирован (т. е. никогда не был добавлен), то этот вызов метода ничего не делает. Если он был добавлен ранее, то он будет удален. Если он был добавлен более одного раза, то будет удалено только первое вхождение.
  
  Определено в:
  
  removeListener in interface ObservableValue<E>
  
  Параметры:
  
  listener - Слушатель для удаления
  
  См. также:
  
  ObservableValue.addListener(ChangeListener)
- addListener
```
public void addListener(ListChangeListener<? super E> listener)
```
  Описание скопировано из интерфейса: ObservableList
  
  Добавить слушателя к этому наблюдаемому списку.
  
  Определено в:
  
  addListener in interface ObservableList<E>
  
  Параметры:
  
  listener - слушатель для прослушивания изменений списка
- removeListener
```
public void removeListener(ListChangeListener<? super E> listener)
```
  Описание скопировано из интерфейса: ObservableList
  
  Пытается удалить слушателя из этого наблюдаемого списка. Если слушатель не прикреплен к этому списку, ничего не произойдет.
  
  Определено в:
  
  removeListener in interface ObservableList<E>
  
  Параметры:
  
  listener - слушатель для удаления
- bind
```
protected final void bind(Observable... dependencies)
```
  Начать наблюдение за зависимостями на предмет изменений. Если значение одной из зависимостей изменится, привязка помечается как недействительная.
  
  Параметры:
  
  dependencies - зависимости для наблюдения
- unbind
```
protected final void unbind(Observable... dependencies)
```
  Прекратить наблюдение за зависимостями на предмет изменений.
  
  Параметры:
  
  dependencies - зависимости для прекращения наблюдения
- dispose
```
public void dispose()
```
  Реализация по умолчанию dispose(), которая пуста.
  
  Определено в:
  
  dispose in interface Binding<E>
- getDependencies
```
public ObservableList<?> getDependencies()
```
  Реализация по умолчанию getDependencies(), которая возвращает пустой ObservableList.
  
  Определено в:
  
  getDependencies in interface Binding<E>
  
  Возвращает:
  
  пустой ObservableList
- get
```
public final ObservableList<E> get()
```
  Возвращает результат computeValue(). Метод computeValue() вызывается только в том случае, если привязка недействительна. Результат кэшируется и возвращается, если привязка не стала недействительной с момента последнего вызова get().
  
  Определено в:
  
  get in interface ObservableObjectValue<E>
  
  Возвращает:
  
  текущее значение
- onInvalidating
```
protected void onInvalidating()
```
  Метод onInvalidating() может быть переопределен расширяющими классами, чтобы реагировать, если эта привязка становится недействительной. Реализация по умолчанию пуста.
- invalidate
```
public final void invalidate()
```
  Описание скопировано из интерфейса: Binding
  
  Пометить привязку как недействительную. Это принудительно пересчитывает значение Binding при следующем запросе.
  
  Определено в:
  
  invalidate in interface Binding<E>
- isValid
```
public final boolean isValid()
```
  Описание скопировано из интерфейса: Binding
  
  Проверяет, является ли привязка действительной.
  
  Определено в:
  
  isValid in interface 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.

Класс ListBinding<E>

Сводка свойств

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

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

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

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

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

Методы, унаследованные от интерфейса java.lang.Iterable

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

Методы, унаследованные от интерфейса javafx.collections.ObservableList

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

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

размер

пустой

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

Method Detail

sizeProperty

emptyProperty

addListener

removeListener

addListener

removeListener

addListener

removeListener

bind

unbind

dispose

getDependencies

get

onInvalidating

invalidate

isValid

computeValue

toString