javafx.collections

Класс FXCollections

java.lang.Object

javafx.collections.FXCollections

public class FXCollections
extends Object

Утилитарный класс, содержащий статические методы, являющиеся 1:1 копиями методов из java.util.Collections.

Методы-обёртки (например, synchronizedObservableList или emptyObservableList) имеют точно такую же функциональность, как и методы в Collections, за исключением того, что они возвращают ObservableList, и поэтому подходят для методов, которые требуют ObservableList в качестве входного параметра.

Эти утилитарные методы в основном предназначены для повышения производительности. Все методы оптимизированы таким образом, чтобы они генерировали только ограниченное число уведомлений. С другой стороны, методы java.util.Collections могут вызывать "методы изменения" в ObservableList многократно, что приводит к большому количеству уведомлений.

С:

JavaFX 2.0

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

Все методыСтатические методыКонкретные методы
Модификатор и тип	Метод и описание
`static <E> ObservableList<E>`	`checkedObservableList(ObservableList<E> list, Class<E> type)` Создаёт и возвращает безопасную оболочку над предоставленным наблюдаемым списком.
`static <K,V> ObservableMap<K,V>`	`checkedObservableMap(ObservableMap<K,V> map, Class<K> keyType, Class<V> valueType)` Создаёт и возвращает безопасную оболочку над предоставленным наблюдаемым отображением.
`static <E> ObservableSet<E>`	`checkedObservableSet(ObservableSet<E> set, Class<E> type)` Создаёт и возвращает безопасную оболочку над предоставленным наблюдаемым множеством.
`static <E> ObservableList<E>`	`concat(ObservableList<E>... lists)` Объединяет несколько наблюдаемых списков в один.
`static <T> void`	`copy(ObservableList<? super T> dest, List<? extends T> src)` Копирует элементы из src в dest.
`static <E> ObservableList<E>`	`emptyObservableList()` Создаёт и возвращает пустой неизменяемый наблюдаемый список.
`static <K,V> ObservableMap<K,V>`	`emptyObservableMap()` Создаёт и возвращает пустое неизменяемое наблюдаемое отображение.
`static <E> ObservableSet<E>`	`emptyObservableSet()` Создаёт и возвращает пустое неизменяемое наблюдаемое множество.
`static <T> void`	`fill(ObservableList<? super T> list, T obj)` Заполняет предоставленный список объектом obj.
`static <E> ObservableList<E>`	`observableArrayList()` Создаёт новый пустой наблюдаемый список, поддерживаемый массивом.
`static <E> ObservableList<E>`	`observableArrayList(Callback<E,Observable[]> extractor)` Создаёт новый пустой наблюдаемый список, поддерживаемый массивом.
`static <E> ObservableList<E>`	`observableArrayList(Collection<? extends E> col)` Создаёт новый наблюдаемый массив и добавляет в него содержимое коллекции `col`.
`static <E> ObservableList<E>`	`observableArrayList(E... items)` Создаёт новый наблюдаемый массив с добавленным в него `items`.
`static ObservableFloatArray`	`observableFloatArray()` Создаёт новый пустой наблюдаемый массив с плавающей запятой.
`static ObservableFloatArray`	`observableFloatArray(float... values)` Создаёт новый наблюдаемый массив с плавающей запятой с заданным значением `values`.
`static ObservableFloatArray`	`observableFloatArray(ObservableFloatArray array)` Создаёт новый наблюдаемый массив с плавающей запятой с копией элементов из заданного `array`.
`static <K,V> ObservableMap<K,V>`	`observableHashMap()` Создаёт новое пустое наблюдаемое отображение, поддерживаемое HashMap.
`static ObservableIntegerArray`	`observableIntegerArray()` Создаёт новый пустой наблюдаемый целочисленный массив.
`static ObservableIntegerArray`	`observableIntegerArray(int... values)` Создаёт новый наблюдаемый целочисленный массив с заданным значением `values`.
`static ObservableIntegerArray`	`observableIntegerArray(ObservableIntegerArray array)` Создаёт новый наблюдаемый целочисленный массив с копией элементов из заданного `array`.
`static <E> ObservableList<E>`	`observableList(List<E> list)` Создаёт ObservableList, поддерживаемый указанным списком.
`static <E> ObservableList<E>`	`observableList(List<E> list, Callback<E,Observable[]> extractor)` Создаёт ObservableList, поддерживаемый указанным списком.
`static <K,V> ObservableMap<K,V>`	`observableMap(Map<K,V> map)` Создаёт ObservableMap, поддерживаемый указанным отображением.
`static <E> ObservableSet<E>`	`observableSet(E... elements)` Создаёт ObservableSet, поддерживаемый HashSet, содержащий все указанные элементы.
`static <E> ObservableSet<E>`	`observableSet(Set<E> set)` Создаёт ObservableSet, поддерживаемый указанным множеством.
`static <T> boolean`	`replaceAll(ObservableList<T> list, T oldVal, T newVal)` Заменяет все элементы oldVal в списке элементом newVal.
`static void`	`reverse(ObservableList list)` Инвертирует порядок в списке. Вызывает одно событие изменения в списке.
`static void`	`rotate(ObservableList list, int distance)` Поворачивает список на расстояние.
`static void`	`shuffle(ObservableList<?> list)` Перемешивает все элементы в наблюдаемом списке.
`static void`	`shuffle(ObservableList list, Random rnd)` Перемешивает все элементы в наблюдаемом списке.
`static <E> ObservableList<E>`	`singletonObservableList(E e)` Создаёт неизменяемый наблюдаемый список с одним элементом.
`static <T extends Comparable<? super T>> void`	`sort(ObservableList<T> list)` Сортирует предоставленный наблюдаемый список.
`static <T> void`	`sort(ObservableList<T> list, Comparator<? super T> c)` Сортирует предоставленный наблюдаемый список, используя компаратор c.
`static <E> ObservableList<E>`	`synchronizedObservableList(ObservableList<E> list)` Создаёт и возвращает синхронизированную оболочку над предоставленным наблюдаемым списком.
`static <K,V> ObservableMap<K,V>`	`synchronizedObservableMap(ObservableMap<K,V> map)` Создаёт и возвращает синхронизированную оболочку над предоставленным наблюдаемым отображением.
`static <E> ObservableSet<E>`	`synchronizedObservableSet(ObservableSet<E> set)` Создаёт и возвращает синхронизированную оболочку над предоставленным наблюдаемым множеством.
`static <E> ObservableList<E>`	`unmodifiableObservableList(ObservableList<E> list)` Создаёт и возвращает неизменяемый оболочечный список над предоставленным наблюдаемым списком.
`static <K,V> ObservableMap<K,V>`	`unmodifiableObservableMap(ObservableMap<K,V> map)` Создаёт интерфейс только для чтения для указанного ObservableMap.
`static <E> ObservableSet<E>`	`unmodifiableObservableSet(ObservableSet<E> set)` Создаёт и возвращает неизменяемую оболочку над предоставленным наблюдаемым множеством.

Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание методов
- observableList
```
public static <E> ObservableList<E> observableList(List<E> list)
```
  Создаёт ObservableList, основанную на указанном списке. Операции изменения в экземпляре ObservableList будут сообщаться наблюдателям, которые зарегистрированы в этом экземпляре.
  Обратите внимание, что операции изменения, выполненные непосредственно в базовом списке, не сообщаются наблюдателям ObservableList, его обернувшего.
  
  Параметры:
  
  list - конкретный список, на котором основана ObservableList
  
  Возвращает:
  
  новый созданный ObservableList
- observableList
```
public static <E> ObservableList<E> observableList(List<E> list,
                                                   Callback<E,Observable[]> extractor)
```
  Создаёт ObservableList, основанную на указанном списке. Операции изменения в экземпляре ObservableList будут сообщаться наблюдателям, которые зарегистрированы в этом экземпляре.
  Обратите внимание, что операции изменения, выполненные непосредственно в базовом списке, не сообщаются наблюдателям ObservableList, его обернувшего.
  Этот список также сообщает об изменениях элементов, используя extractor. Наблюдаемые объекты, возвращаемые экстрактором (применённым к каждому элементу списка), отслеживаются на изменения и преобразуются в изменение "обновления" ListChangeListener.
  
  Параметры:
  
  list - конкретный список, на котором основана ObservableList
  
  Возвращает:
  
  новый созданный ObservableList
  
  С:
  
  JavaFX 2.1
- observableMap
```
public static <K,V> ObservableMap<K,V> observableMap(Map<K,V> map)
```
  Создаёт ObservableMap, основанную на указанной карте. Операции изменения в экземпляре ObservableMap будут сообщаться наблюдателям, которые зарегистрированы в этом экземпляре.
  Обратите внимание, что операции изменения, выполненные непосредственно в базовой карте, не сообщаются наблюдателям ObservableMap, её обернувшего.
  
  Параметры:
  
  map - карта, на которой основана ObservableMap
  
  Возвращает:
  
  новый созданный ObservableMap
- observableSet
```
public static <E> ObservableSet<E> observableSet(Set<E> set)
```
  Создаёт ObservableSet, основанную на указанном множестве. Операции изменения в экземпляре ObservableSet будут сообщаться наблюдателям, которые зарегистрированы в этом экземпляре.
  Обратите внимание, что операции изменения, выполненные непосредственно в базовом множестве, не сообщаются наблюдателям ObservableSet, его обернувшего.
  
  Параметры:
  
  set - множество, на котором основана ObservableSet
  
  Возвращает:
  
  новый созданный ObservableSet
  
  С:
  
  JavaFX 2.1
- observableSet
```
public static <E> ObservableSet<E> observableSet(E... elements)
```
  Создаёт ObservableSet, основанную на HashSet, содержащую все указанные элементы.
  
  Параметры:
  
  elements - элементы, которые будут добавлены в возвращаемый ObservableSet
  
  Возвращает:
  
  новый созданный ObservableSet
  
  С:
  
  JavaFX 2.1
- unmodifiableObservableMap
```
public static <K,V> ObservableMap<K,V> unmodifiableObservableMap(ObservableMap<K,V> map)
```
  Создаёт интерфейс только для чтения для указанного ObservableMap. Только операции изменения, выполненные в базовом ObservableMap, будут сообщаться наблюдателям, зарегистрированным в неизменяемом экземпляре. Это позволяет клиентам отслеживать изменения в карте, но запрещает возможность её изменения.
  
  Параметры:
  
  map - ObservableMap, которая должна отслеживаться этим интерфейсом
  
  Возвращает:
  
  новый созданный UnmodifiableObservableMap
- checkedObservableMap
```
public static <K,V> ObservableMap<K,V> checkedObservableMap(ObservableMap<K,V> map,
                                                            Class<K> keyType,
                                                            Class<V> valueType)
```
  Создаёт и возвращает безопасную по типу оболочку поверх предоставленной наблюдаемой карты.
  
  Параметры:
  
  map - Observable-карта, которая должна быть обернута
  
  Возвращает:
  
  динамически безопасный вид указанной карты
  
  С:
  
  JavaFX 8.0
  
  См. также:
  
  Collections#checkedMap(java.util.Map, java.lang.Class)
- synchronizedObservableMap
```
public static <K,V> ObservableMap<K,V> synchronizedObservableMap(ObservableMap<K,V> map)
```
  Создаёт и возвращает синхронизированную оболочку поверх предоставленной наблюдаемой карты.
  
  Параметры:
  
  map - карта, которая должна быть "обернута" в синхронизированную карту.
  
  Возвращает:
  
  синхронизированная версия наблюдаемой карты
  
  С:
  
  JavaFX 8.0
  
  См. также:
  
  Collections.synchronizedMap(java.util.Map)
- emptyObservableMap
```
public static <K,V> ObservableMap<K,V> emptyObservableMap()
```
  Создаёт и возвращает пустую неизменяемую наблюдаемую карту.
  
  Возвращает:
  
  пустая неизменяемая наблюдаемая карта
  
  С:
  
  JavaFX 8.0
  
  См. также:
  
  Collections.emptyMap()
- observableIntegerArray
```
public static ObservableIntegerArray observableIntegerArray()
```
  Создаёт новый пустой наблюдаемый целочисленный массив.
  
  Возвращает:
  
  новый созданный ObservableIntegerArray
  
  С:
  
  JavaFX 8.0
- observableIntegerArray
```
public static ObservableIntegerArray observableIntegerArray(int... values)
```
  Создаёт новый наблюдаемый целочисленный массив с values, заданным для него.
  
  Параметры:
  
  values - значения, которые будут в новом наблюдаемом целочисленном массиве
  
  Возвращает:
  
  новый созданный ObservableIntegerArray
  
  С:
  
  JavaFX 8.0
- observableIntegerArray
```
public static ObservableIntegerArray observableIntegerArray(ObservableIntegerArray array)
```
  Создаёт новый наблюдаемый целочисленный массив с копией элементов в заданном array.
  
  Параметры:
  
  array - наблюдаемый целочисленный массив для копирования
  
  Возвращает:
  
  новый созданный ObservableIntegerArray
  
  С:
  
  JavaFX 8.0
- observableFloatArray
```
public static ObservableFloatArray observableFloatArray()
```
  Создаёт новый пустой наблюдаемый массив с плавающей точкой.
  
  Возвращает:
  
  новый созданный ObservableFloatArray
  
  С:
  
  JavaFX 8.0
- observableFloatArray
```
public static ObservableFloatArray observableFloatArray(float... values)
```
  Создаёт новый наблюдаемый массив с плавающей точкой с values, заданным для него.
  
  Параметры:
  
  values - значения, которые будут в новом наблюдаемом массиве с плавающей точкой
  
  Возвращает:
  
  новый созданный ObservableFloatArray
  
  С:
  
  JavaFX 8.0
- observableFloatArray
```
public static ObservableFloatArray observableFloatArray(ObservableFloatArray array)
```
  Создаёт новый наблюдаемый массив с плавающей точкой с копией элементов в заданном array.
  
  Параметры:
  
  array - наблюдаемый массив с плавающей точкой для копирования
  
  Возвращает:
  
  новый созданный ObservableFloatArray
  
  С:
  
  JavaFX 8.0
- observableArrayList
```
public static <E> ObservableList<E> observableArrayList()
```
  Создаёт новый пустой наблюдаемый список, основанный на ArrayList.
  
  Возвращает:
  
  новый созданный ObservableList
  
  См. также:
  
  observableList(java.util.List)
- observableArrayList
```
public static <E> ObservableList<E> observableArrayList(Callback<E,Observable[]> extractor)
```
  Создаёт новый пустой наблюдаемый список, основанный на ArrayList. Этот список сообщает об обновлениях элементов.
  
  Параметры:
  
  extractor - преобразователь элементов в Observable[]. Наблюдаемые объекты отслеживаются на изменения элемента.
  
  Возвращает:
  
  новый созданный ObservableList
  
  С:
  
  JavaFX 2.1
  
  См. также:
  
  observableList(java.util.List, javafx.util.Callback)
- observableArrayList
```
public static <E> ObservableList<E> observableArrayList(E... items)
```
  Создаёт новый наблюдаемый список ArrayList с добавленными в него items.
  
  Параметры:
  
  items - элементы, которые будут в новом наблюдаемом ArrayList
  
  Возвращает:
  
  новый созданный observableArrayList
  
  См. также:
  
  observableArrayList()
- observableArrayList
```
public static <E> ObservableList<E> observableArrayList(Collection<? extends E> col)
```
  Создаёт новый наблюдаемый список ArrayList и добавляет содержимое коллекции col в него.
  
  Параметры:
  
  col - коллекция, чьё содержимое должно быть добавлено в observableArrayList
  
  Возвращает:
  
  новый созданный observableArrayList
- observableHashMap
```
public static <K,V> ObservableMap<K,V> observableHashMap()
```
  Создаёт новый пустой наблюдаемый список, основанный на HashMap.
  
  Параметры типа:
  
  K - тип ключей
  
  Возвращает:
  
  новый созданный observable HashMap
- concat
```
public static <E> ObservableList<E> concat(ObservableList<E>... lists)
```
  Конкатенирует несколько наблюдаемых списков в один. Результирующий список будет основан на ArrayList.
  
  Параметры:
  
  lists - списки для конкатенации
  
  Возвращает:
  
  новый наблюдаемый список ArrayList, конкатенированный из аргументов
- unmodifiableObservableList
```
public static <E> ObservableList<E> unmodifiableObservableList(ObservableList<E> list)
```
  Создаёт и возвращает неизменяемую оболочку списка поверх предоставленного наблюдаемого списка.
  
  Параметры:
  
  list - ObservableList, которая должна быть обернута
  
  Возвращает:
  
  оболочка ObservableList, которая является неизменяемой
  
  См. также:
  
  Collections.unmodifiableList(java.util.List)

- checkedObservableList
```
public static <E> ObservableList<E> checkedObservableList(ObservableList<E> list,
                                                          Class<E> type)
```
  Создаёт и возвращает безопасную оболочку над предоставленным наблюдаемым списком.
  
  Параметры:
  
  list - наблюдаемый список, который нужно обернуть
  
  Возвращает:
  
  динамически типизированный вид указанного списка
  
  См. также:
  
  Collections.checkedList(java.util.List, java.lang.Class)
- synchronizedObservableList
```
public static <E> ObservableList<E> synchronizedObservableList(ObservableList<E> list)
```
  Создаёт и возвращает синхронизированную оболочку над предоставленным наблюдаемым списком.
  
  Параметры:
  
  list - список, который нужно обернуть в синхронизированный список.
  
  Возвращает:
  
  синхронизированную версию наблюдаемого списка
  
  См. также:
  
  Collections.synchronizedList(java.util.List)
- emptyObservableList
```
public static <E> ObservableList<E> emptyObservableList()
```
  Создаёт пустой неизменяемый наблюдаемый список.
  
  Возвращает:
  
  пустой неизменяемый наблюдаемый список
  
  См. также:
  
  Collections.emptyList()
- singletonObservableList
```
public static <E> ObservableList<E> singletonObservableList(E e)
```
  Создаёт неизменяемый наблюдаемый список с единственным элементом.
  
  Параметры:
  
  e - единственный элемент, который будет содержаться в этом наблюдаемом списке-синглтоне
  
  Возвращает:
  
  наблюдаемый список-синглтон
  
  См. также:
  
  Collections.singletonList(java.lang.Object)
- unmodifiableObservableSet
```
public static <E> ObservableSet<E> unmodifiableObservableSet(ObservableSet<E> set)
```
  Создаёт и возвращает неизменяемую оболочку над предоставленным наблюдаемым набором.
  
  Параметры:
  
  set - наблюдаемый набор, который нужно обернуть
  
  Возвращает:
  
  оболочку ObserableSet, которая является неизменяемой
  
  С:
  
  JavaFX 8.0
  
  См. также:
  
  Collections.unmodifiableSet(java.util.Set)
- checkedObservableSet
```
public static <E> ObservableSet<E> checkedObservableSet(ObservableSet<E> set,
                                                        Class<E> type)
```
  Создаёт и возвращает безопасную оболочку над предоставленным наблюдаемым набором.
  
  Параметры:
  
  set - наблюдаемый набор, который нужно обернуть
  
  Возвращает:
  
  динамически типизированный вид указанного набора
  
  С:
  
  JavaFX 8.0
  
  См. также:
  
  Collections.checkedSet(java.util.Set, java.lang.Class)
- synchronizedObservableSet
```
public static <E> ObservableSet<E> synchronizedObservableSet(ObservableSet<E> set)
```
  Создаёт и возвращает синхронизированную оболочку над предоставленным наблюдаемым набором.
  
  Параметры:
  
  set - набор, который нужно обернуть в синхронизированный набор.
  
  Возвращает:
  
  синхронизированную версию наблюдаемого набора
  
  С:
  
  JavaFX 8.0
  
  См. также:
  
  Collections.synchronizedSet(java.util.Set)
- emptyObservableSet
```
public static <E> ObservableSet<E> emptyObservableSet()
```
  Создаёт пустой неизменяемый наблюдаемый набор.
  
  Возвращает:
  
  пустой неизменяемый наблюдаемый набор
  
  С:
  
  JavaFX 8.0
  
  См. также:
  
  Collections.emptySet()
- copy
```
public static <T> void copy(ObservableList<? super T> dest,
                            List<? extends T> src)
```
  Копирует элементы из src в dest. Вызывает только одну уведомление об изменении в dest.
  
  Параметры:
  
  dest - целевой наблюдаемый список
  
  См. также:
  
  Collections.copy(java.util.List, java.util.List)
- fill
```
public static <T> void fill(ObservableList<? super T> list,
                            T obj)
```
  Заполняет предоставленный список объектом obj. Вызывает только одну уведомление об изменении в списке.
  
  Параметры:
  
  list - список для заполнения
  
  См. также:
  
  Collections.fill(java.util.List, java.lang.Object)
- replaceAll
```
public static <T> boolean replaceAll(ObservableList<T> list,
                                     T oldVal,
                                     T newVal)
```
  Заменяет все элементы oldVal в списке элементом newVal. Вызывает только одну уведомление об изменении в списке.
  
  Параметры:
  
  list - список, элементы которого будут заменены
  
  Возвращает:
  
  true, если список был изменён
  
  См. также:
  
  Collections.replaceAll(java.util.List, java.lang.Object, java.lang.Object)
- reverse
```
public static void reverse(ObservableList list)
```
  Обращает порядок элементов в списке. Вызывает только одну уведомление об изменении в списке.
  
  Параметры:
  
  list - список, который нужно перевернуть
  
  См. также:
  
  Collections.reverse(java.util.List)
- rotate
```
public static void rotate(ObservableList list,
                          int distance)
```
  Поворачивает список на расстояние. Вызывает только одну уведомление об изменении в списке.
  
  Параметры:
  
  list - список, который нужно повернуть
  
  См. также:
  
  Collections.rotate(java.util.List, int)
- shuffle
```
public static void shuffle(ObservableList<?> list)
```
  Перемешивает все элементы в наблюдаемом списке. Вызывает только одну уведомление об изменении в списке.
  
  Параметры:
  
  list - список, который нужно перемешать
  
  См. также:
  
  Collections.shuffle(java.util.List)
- shuffle
```
public static void shuffle(ObservableList list,
                           Random rnd)
```
  Перемешивает все элементы в наблюдаемом списке. Вызывает только одну уведомление об изменении в списке.
  
  Параметры:
  
  list - список, который нужно перемешать
  
  См. также:
  
  Collections.shuffle(java.util.List, java.util.Random)
- sort
```
public static <T extends Comparable<? super T>> void sort(ObservableList<T> list)
```
  Сортирует предоставленный наблюдаемый список. Вызывает только одну уведомление об изменении в списке.
  
  См. также:
  
  Collections.sort(java.util.List)
- sort
```
public static <T> void sort(ObservableList<T> list,
                            Comparator<? super T> c)
```
  Сортирует предоставленный наблюдаемый список, используя компаратор c. Вызывает только одну уведомление об изменении в списке.
  
  Параметры:
  
  list - список, который нужно отсортировать
  
  См. также:
  
  Collections.sort(java.util.List, java.util.Comparator)

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

Класс FXCollections

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

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

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

observableList

observableList

observableMap

observableSet

observableSet

unmodifiableObservableMap

checkedObservableMap

synchronizedObservableMap

emptyObservableMap

observableIntegerArray

observableIntegerArray

observableIntegerArray

observableFloatArray

observableFloatArray

observableFloatArray

observableArrayList

observableArrayList

observableArrayList

observableArrayList

observableHashMap

concat

unmodifiableObservableList

checkedObservableList

synchronizedObservableList

emptyObservableList

singletonObservableList

unmodifiableObservableSet

checkedObservableSet

synchronizedObservableSet

emptyObservableSet

copy

fill

replaceAll

reverse

rotate

shuffle

shuffle

sort

sort