Класс FXCollections

java.lang.Object

javafx.collections.FXCollections

public class FXCollections
extends Object

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

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

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

Since:: JavaFX 2.0

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

Modifier and Type	Method	Description
`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(E... items)`	Создает новый наблюдаемый список массивов с добавленным в него `items`.
`static <E> ObservableList<E>`	`observableArrayList(Collection<? extends E> col)`	Создает новый наблюдаемый список массивов и добавляет в него содержимое коллекции `col`.
`static <E> ObservableList<E>`	`observableArrayList(Callback<E,Observable[]> extractor)`	Создает новый пустой `ObservableList`, который поддерживается списком массивов и прослушивает изменения в наблюдаемых объектах своих элементов.
`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, которая его оборачивает.

Параметры типа:: E - Тип List, который будет обернут
Параметры:: list - конкретный List, который лежит в основе ObservableList
Возвращает:: новосозданный ObservableList

observableList

public static <E> ObservableList<E> observableList(List<E> list, Callback<E,Observable[]> extractor)

Создаёт ObservableList, которая основана на указанном списке и отслеживает изменения в наблюдаемых объектов в своих элементах. Операции изменения, выполненные непосредственно в базовом списке, не сообщаются наблюдателям любой ObservableList, которая его оборачивает.

extractor возвращает наблюдаемые объекты (обычно свойства) объектов в созданном списке. За изменениями этих наблюдаемых объектов ведётся отслеживание, и пользователь уведомляется об этих изменениях посредством изменения update присоединённого ListChangeListener. Эти изменения не связаны с изменениями, внесёнными в сам наблюдаемый список с помощью таких методов, как add и remove.

Например, список Shape может отслеживать изменения в свойстве fill фигур.

Параметры типа:: E - Тип List для обертывания
Параметры:: list - конкретный List, лежащий в основе этой ObservableList; extractor - преобразователь элемента в Observable[]
Возвращает:: новосозданный ObservableList
С момента:: JavaFX 2.1
См. также:: observableArrayList(javafx.util.Callback)

observableMap

public static <K, V> ObservableMap<K,V> observableMap(Map<K,V> map)

Создаёт ObservableMap, которая основана на указанном словаре. Операции изменения в ObservableMap будут сообщаться наблюдателям, зарегистрированным в этом экземпляре.
Обратите внимание, что операции изменения, выполненные непосредственно в базовом словаре, не сообщаются наблюдателям любой ObservableMap, которая его оборачивает.

Параметры типа:: K - тип обернутого ключа; V - тип обернутого значения
Параметры:: map - словарь, лежащий в основе ObservableMap
Возвращает:: новосозданный ObservableMap

observableSet

public static <E> ObservableSet<E> observableSet(Set<E> set)

Создаёт ObservableSet, которая основана на указанном множестве. Операции изменения в ObservableSet будут сообщаться наблюдателям, зарегистрированным в этом экземпляре.
Обратите внимание, что операции изменения, выполненные непосредственно в базовом множестве, не сообщаются наблюдателям любой ObservableSet, которая его оборачивает.

Параметры типа:: E - тип списка для обертывания
Параметры:: set - множество, лежащее в основе ObservableSet
Возвращает:: новосозданное ObservableSet
С момента:: JavaFX 2.1

observableSet

public static <E> ObservableSet<E> observableSet(E... elements)

Создаёт ObservableSet, основанную на HashSet, содержащую все указанные элементы.

Параметры типа:: E - тип списка для обертывания
Параметры:: elements - элементы, которые будут добавлены в возвращаемое ObservableSet
Возвращает:: новосозданное ObservableSet
С момента:: JavaFX 2.1

unmodifiableObservableMap

public static <K, V> ObservableMap<K,V> unmodifiableObservableMap(ObservableMap<K,V> map)

Создаёт интерфейс только для чтения к указанному ObservableMap. Только операции изменения, выполненные в базовом ObservableMap, будут сообщаться наблюдателям, зарегистрированным в неизменяемом экземпляре. Это позволяет клиентам отслеживать изменения в словаре, но запрещает возможность его изменения.

Параметры типа:: K - тип обернутого ключа; V - тип обернутого значения
Параметры:: map - ObservableMap, которая должна отслеживаться этим интерфейсом
Возвращает:: новосозданный UnmodifiableObservableMap

checkedObservableMap

public static <K, V> ObservableMap<K,V> checkedObservableMap(ObservableMap<K,V> map, Class<K> keyType, Class<V> valueType)

Создаёт и возвращает безопасную для типов оболочку поверх предоставленного наблюдаемого словаря.

Параметры типа:: K - тип обернутого ключа; V - тип обернутого значения
Параметры:: map - наблюдаемый словарь для обертывания; keyType - тип ключа, который map разрешено содержать; valueType - тип значения, которое map разрешено содержать
Возвращает:: динамически безопасный вид указанного словаря
С момента:: JavaFX 8.0
См. также:: Collections.checkedMap(java.util.Map, java.lang.Class, java.lang.Class)

synchronizedObservableMap

public static <K, V> ObservableMap<K,V> synchronizedObservableMap(ObservableMap<K,V> map)

Создаёт и возвращает синхронизированную оболочку поверх предоставленного наблюдаемого словаря.

Параметры типа:: K - тип обернутого ключа; V - тип обернутого значения
Параметры:: map - словарь, который нужно "обернуть" в синхронизированный словарь.
Возвращает:: Синхронизированная версия наблюдаемого словаря
С момента:: JavaFX 8.0
См. также:: Collections.synchronizedMap(java.util.Map)

emptyObservableMap

public static <K, V> ObservableMap<K,V> emptyObservableMap()

Создаёт пустой неизменяемый наблюдаемый словарь.

Параметры типа:: K - тип обернутого ключа; V - тип обернутого значения
Возвращает:: Пустой неизменяемый наблюдаемый словарь
С момента:: 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.

Параметры типа:: E - тип списка для обертывания
Возвращает:: новосозданный ObservableList
См. также:: observableList(java.util.List)

observableArrayList

public static <E> ObservableList<E> observableArrayList(Callback<E,Observable[]> extractor)

Создаёт новый пустой ObservableList, который поддерживается списком массивов и следит за изменениями в наблюдаемых элементах.

extractor возвращает наблюдаемые элементы (обычно свойства) объектов в созданном списке. За этими наблюдаемыми отслеживаются изменения, и пользователь уведомляется об этих изменениях с помощью изменения обновления прикреплённого ListChangeListener. Эти изменения не связаны с изменениями, внесёнными в сам список наблюдаемых с помощью таких методов, как add и remove.

Например, список Shape может следить за изменениями в свойстве fill фигур.

Type Parameters:: E - Тип List, который следует обернуть
Parameters:: extractor - преобразователь элементов в Observable[]
Returns:: новый созданный ObservableList
Since:: JavaFX 2.1
See Also:: observableList(java.util.List, javafx.util.Callback)

observableArrayList

public static <E> ObservableList<E> observableArrayList(E... items)

Создаёт новый наблюдаемый список массивов с добавленными в него items.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: items - элементы, которые будут в новом наблюдаемом списке ArrayList
Returns:: новый созданный observableArrayList
See Also:: observableArrayList()

observableArrayList

public static <E> ObservableList<E> observableArrayList(Collection<? extends E> col)

Создаёт новый наблюдаемый список массивов и добавляет содержимое коллекции col в него.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: col - коллекция, содержимое которой должно быть добавлено в observableArrayList
Returns:: новый созданный observableArrayList

observableHashMap

public static <K, V> ObservableMap<K,V> observableHashMap()

Создаёт новый пустой наблюдаемый словарь, поддерживаемый HashMap.

Type Parameters:: K - тип обернутого ключа; V - тип обернутого значения
Returns:: новый созданный observable HashMap

concat

public static <E> ObservableList<E> concat(ObservableList<E>... lists)

Объединяет несколько наблюдаемых списков в один. Результирующий список будет поддерживаться списком массивов.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: lists - списки для объединения
Returns:: новый наблюдаемый список массивов, объединённый из аргументов

unmodifiableObservableList

public static <E> ObservableList<E> unmodifiableObservableList(ObservableList<E> list)

Создаёт и возвращает неизменяемый оберточный список поверх заданного наблюдаемого списка.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: list - наблюдаемый список, который следует обернуть
Returns:: оберточный наблюдаемый список, который является неизменяемым
See Also:: Collections.unmodifiableList(java.util.List)

checkedObservableList

public static <E> ObservableList<E> checkedObservableList(ObservableList<E> list, Class<E> type)

Создаёт и возвращает безопасный для типов оберточный список поверх заданного наблюдаемого списка.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: list - наблюдаемый список, который следует обернуть; type - тип элемента, который list разрешается содержать
Returns:: динамически безопасный вид заданного списка
See Also:: Collections.checkedList(java.util.List, java.lang.Class)

synchronizedObservableList

public static <E> ObservableList<E> synchronizedObservableList(ObservableList<E> list)

Создаёт и возвращает синхронизированный оберточный список поверх заданного наблюдаемого списка.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: list - список, который следует "обернуть" в синхронизированный список.
Returns:: Синхронизированная версия наблюдаемого списка
See Also:: Collections.synchronizedList(java.util.List)

emptyObservableList

public static <E> ObservableList<E> emptyObservableList()

Создаёт пустой неизменяемый наблюдаемый список.

Type Parameters:: E - Тип списка, который следует обернуть
Returns:: Пустой неизменяемый наблюдаемый список
See Also:: Collections.emptyList()

singletonObservableList

public static <E> ObservableList<E> singletonObservableList(E e)

Создаёт неизменяемый наблюдаемый список с одним элементом.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: e - единственные элементы, которые будут содержаться в этом одиночном наблюдаемом списке
Returns:: одиночный наблюдаемый список
See Also:: Collections.singletonList(java.lang.Object)

unmodifiableObservableSet

public static <E> ObservableSet<E> unmodifiableObservableSet(ObservableSet<E> set)

Создаёт и возвращает неизменяемый оберточный набор поверх заданного наблюдаемого набора.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: set - наблюдаемый набор, который следует обернуть
Returns:: оберточный наблюдаемый набор, который является неизменяемым
Since:: JavaFX 8.0
See Also:: Collections.unmodifiableSet(java.util.Set)

checkedObservableSet

public static <E> ObservableSet<E> checkedObservableSet(ObservableSet<E> set, Class<E> type)

Создаёт и возвращает набор, безопасный для типов, поверх заданного наблюдаемого набора.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: set - наблюдаемый набор, который следует обернуть; type - тип элемента, который set разрешается содержать
Returns:: динамически безопасный вид заданного набора
Since:: JavaFX 8.0
See Also:: Collections.checkedSet(java.util.Set, java.lang.Class)

synchronizedObservableSet

public static <E> ObservableSet<E> synchronizedObservableSet(ObservableSet<E> set)

Создаёт и возвращает синхронизированный оберточный набор поверх заданного наблюдаемого набора.

Type Parameters:: E - Тип списка, который следует обернуть
Parameters:: set - набор, который следует "обернуть" в синхронизированный набор.
Returns:: Синхронизированная версия наблюдаемого набора
Since:: JavaFX 8.0
See Also:: Collections.synchronizedSet(java.util.Set)

emptyObservableSet

public static <E> ObservableSet<E> emptyObservableSet()

Создаёт пустой неизменяемый наблюдаемый набор.

Type Parameters:: E - Тип списка, который следует обернуть
Returns:: Пустой неизменяемый наблюдаемый набор
Since:: JavaFX 8.0
See Also:: Collections.emptySet()

copy

public static <T> void copy(ObservableList<? super T> dest, List<? extends T> src)

Копирует элементы из src в dest. Срабатывает только одно уведомление об изменении в dest.

Type Parameters:: T - Тип списка, который следует обернуть
Parameters:: dest - целевой наблюдаемый список; src - исходный список
See Also:: Collections.copy(java.util.List, java.util.List)

заполнить

public static <T> void fill(ObservableList<? super T> list, T obj)

Заполняет предоставленный список obj. Вызывает только одну уведомление об изменении в списке.

Параметры типа:: T - Тип списка, который будет обернут
Параметры:: list - список для заполнения; obj - объект для заполнения списка
См. также:: Collections.fill(java.util.List, java.lang.Object)

заменитьВсе

public static <T> boolean replaceAll(ObservableList<T> list, T oldVal, T newVal)

Заменяет все элементы oldVal в списке на элемент newVal. Вызывает только одну уведомление об изменении в списке.

Параметры типа:: T - Тип списка, который будет обернут
Параметры:: list - список, элементы которого будут заменены; oldVal - элемент, который будет заменён; newVal - замена
Возвращает:: true, если список был изменён
См. также:: Collections.replaceAll(java.util.List, java.lang.Object, java.lang.Object)

обратить

public static void reverse(ObservableList list)

Обращает порядок элементов в списке. Вызывает только одну уведомление об изменении в списке.

Параметры:: list - список, который нужно обратить
См. также:: Collections.reverse(java.util.List)

вращать

public static void rotate(ObservableList list, int distance)

Вращает список на заданное расстояние. Вызывает только одну уведомление об изменении в списке.

Параметры:: list - список, который нужно повернуть; distance - расстояние поворота
См. также:: Collections.rotate(java.util.List, int)

перемешать

public static void shuffle(ObservableList<?> list)

Перемешивает все элементы в наблюдаемом списке. Вызывает только одну уведомление об изменении в списке.

Параметры:: list - список для перемешивания
См. также:: Collections.shuffle(java.util.List)

перемешать

public static void shuffle(ObservableList list, Random rnd)

Перемешивает все элементы в наблюдаемом списке. Вызывает только одну уведомление об изменении в списке.

Параметры:: list - список для перемешивания; rnd - генератор случайных чисел, используемый для перемешивания
См. также:: Collections.shuffle(java.util.List, java.util.Random)

сортировать

public static <T extends Comparable<? super T>> void sort(ObservableList<T> list)

Сортирует предоставленный наблюдаемый список. Вызывает только одну уведомление об изменении в списке.

Параметры типа:: T - Тип списка, который будет обернут
Параметры:: list - список для сортировки
См. также:: Collections.sort(java.util.List)

сортировать

public static <T> void sort(ObservableList<T> list, Comparator<? super T> c)

Сортирует предоставленный наблюдаемый список, используя компаратор c. Вызывает только одну уведомление об изменении в списке.

Параметры типа:: T - Тип списка, который будет обернут
Параметры:: list - список для сортировки; c - компаратор, используемый для сортировки. null, если требуется естественный порядок.
См. также:: 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.