Класс 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 несколько раз, что приводит к большому количеству уведомлений.

Since:: 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(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)`	Сортирует предоставленный наблюдаемый список в соответствии со спецификациями в `Collections.sort(List)`.
`static <T> void`	`sort(ObservableList<T> list, Comparator<? super T> comparator)`	Сортирует предоставленный наблюдаемый список в соответствии со спецификациями в `Collections.sort(List, Comparator)`.
`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 возвращает наблюдаемые элементы (обычно свойства) объектов в созданном списке. Эти наблюдаемые отслеживаются на изменения, и пользователь уведомляется об этих изменениях через событие обновления прикреплённого 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 - Тип List, который будет обернут
Параметры:: set - множество, являющееся основой для этого ObservableSet
Возвращает:: новый созданный ObservableSet
С:: JavaFX 2.1

observableSet

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

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

Параметры типа:: E - Тип List, который будет обернут
Параметры:: 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()

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

Параметры типа:

E - Тип List, который будет обернут

Возвращает:

новый созданный 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 - единственный элемент, который будет содержаться в этом наблюдаемом списке singleton

Returns:

наблюдаемый список singleton

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()

копировать

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

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

Параметры типа:

T - Тип списка, который нужно обернуть

Параметры:

dest - целевой список observable

src - исходный список

См. также:

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)

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

Параметры:

list - список для перемешивания

См. также:

Collections.shuffle(java.util.List)

перемешать

public static void shuffle(ObservableList list, Random rnd)

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

Параметры:

list - список для перемешивания

rnd - генератор случайных чисел, используемый для перемешивания

См. также:

Collections.shuffle(java.util.List, java.util.Random)

сортировать

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

Сортирует предоставленный список observable, как указано в Collections.sort(List). Вызывает только одну уведомление об изменении в списке.

Параметры типа:: T - тип элементов в этом списке
Параметры:: list - список, который нужно отсортировать

сортировать

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

Сортирует предоставленный список observable, как указано в Collections.sort(List, Comparator). Вызывает только одну уведомление об изменении в списке.

Параметры типа:: T - тип элементов в этом списке
Параметры:: list - список, который нужно отсортировать; comparator - компаратор для определения порядка списка. Значение null указывает, что следует использовать естественный порядок элементов.

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