Класс FXCollections

java.lang.Object

fx.collections.FXCollections

public class FXCollections extends Object

Утилитарный класс, состоящий из статических методов, являющихся прямым соответствием методам 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)`	Создаёт и возвращает безопасную по типу обёртку поверх предоставленного observable списка.
`static <K, V> ObservableMap<K,V>`	`checkedObservableMap(ObservableMap<K,V> map, Class<K> keyType, Class<V> valueType)`	Создаёт и возвращает безопасную по типу обёртку поверх предоставленной observable карты.
`static <E> ObservableSet<E>`	`checkedObservableSet(ObservableSet<E> set, Class<E> type)`	Создаёт и возвращает безопасную по типу обёртку поверх предоставленного observable набора.
`static <E> ObservableList<E>`	`concat(ObservableList<E>... lists)`	Конкатенирует несколько observable списков в один.
`static <T> void`	`copy(ObservableList<? super T> dest, List<? extends T> src)`	Копирует элементы из src в dest.
`static <E> ObservableList<E>`	`emptyObservableList()`	Создаёт и возвращает пустой неизменяемый observable список.
`static <K, V> ObservableMap<K,V>`	`emptyObservableMap()`	Создаёт и возвращает пустую неизменяемую observable карту.
`static <E> ObservableSet<E>`	`emptyObservableSet()`	Создаёт и возвращает пустой неизменяемый observable набор.
`static <T> void`	`fill(ObservableList<? super T> list, T obj)`	Заполняет предоставленный список элементом obj.
`static <E> ObservableList<E>`	`observableArrayList()`	Создаёт новый пустой observable список, поддерживаемый списком ArrayList.
`static <E> ObservableList<E>`	`observableArrayList(E... items)`	Создаёт новый observable список ArrayList, с элементом `items` добавленным в него.
`static <E> ObservableList<E>`	`observableArrayList(Collection<? extends E> col)`	Создаёт новый observable список ArrayList и добавляет содержимое коллекции `col` в него.
`static <E> ObservableList<E>`	`observableArrayList(Callback<E,Observable[]> extractor)`	Создаёт новый пустой `ObservableList`, поддерживаемый списком ArrayList, и прослушивает изменения в observable элементах своих элементов.
`static ObservableFloatArray`	`observableFloatArray()`	Создаёт новый пустой observable массив float.
`static ObservableFloatArray`	`observableFloatArray(float... values)`	Создаёт новый observable массив float с элементом `values` в нём.
`static ObservableFloatArray`	`observableFloatArray(ObservableFloatArray array)`	Создаёт новый observable массив float с копией элементов в заданном `array`.
`static <K, V> ObservableMap<K,V>`	`observableHashMap()`	Создаёт новую пустую observable карту, поддерживаемую HashMap.
`static ObservableIntegerArray`	`observableIntegerArray()`	Создаёт новый пустой observable массив целых чисел.
`static ObservableIntegerArray`	`observableIntegerArray(int... values)`	Создаёт новый observable массив целых чисел с элементом `values` в нём.
`static ObservableIntegerArray`	`observableIntegerArray(ObservableIntegerArray array)`	Создаёт новый observable массив целых чисел с копией элементов в заданном `array`.
`static <E> ObservableList<E>`	`observableList(List<E> list)`	Создаёт ObservableList, поддерживаемый указанным списком.
`static <E> ObservableList<E>`	`observableList(List<E> list, Callback<E,Observable[]> extractor)`	Создаёт `ObservableList`, поддерживаемый указанным списком, и прослушивает изменения в observable элементах своих элементов.
`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)`	Поворачивает список на расстояние distance.
`static void`	`shuffle(ObservableList<?> list)`	Перемешивает все элементы в observable списке.
`static void`	`shuffle(ObservableList list, Random rnd)`	Перемешивает все элементы в observable списке.
`static <E> ObservableList<E>`	`singletonObservableList(E e)`	Создаёт неизменяемый observable список с одним элементом.
`static <T extends Comparable<? super T>> void`	`sort(ObservableList<T> list)`	Сортирует предоставленный observable список в соответствии с `Collections.sort(List)`.
`static <T> void`	`sort(ObservableList<T> list, Comparator<? super T> comparator)`	Сортирует предоставленный observable список в соответствии с `Collections.sort(List, Comparator)`.
`static <E> ObservableList<E>`	`synchronizedObservableList(ObservableList<E> list)`	Создаёт и возвращает синхронизированную обёртку поверх предоставленного observable списка.
`static <K, V> ObservableMap<K,V>`	`synchronizedObservableMap(ObservableMap<K,V> map)`	Создаёт и возвращает синхронизированную обёртку поверх предоставленной observable карты.
`static <E> ObservableSet<E>`	`synchronizedObservableSet(ObservableSet<E> set)`	Создаёт и возвращает синхронизированную обёртку поверх предоставленного observable набора.
`static <E> ObservableList<E>`	`unmodifiableObservableList(ObservableList<E> list)`	Создаёт и возвращает неизменяемую обёртку списка поверх предоставленного observable списка.
`static <K, V> ObservableMap<K,V>`	`unmodifiableObservableMap(ObservableMap<K,V> map)`	Создаёт интерфейс только для чтения к указанной ObservableMap.
`static <E> ObservableSet<E>`	`unmodifiableObservableSet(ObservableSet<E> set)`	Создаёт и возвращает неизменяемую обёртку поверх предоставленного observable набора.

Методы, объявленные в классе 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 - конкретный список, который является основой для 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 - конкретный список, который является основой для ObservableList

extractor - преобразователь элемента в наблюдаемое свойство

Возвращает:

новый созданный ObservableList

С:

JavaFX 2.1

См. также:

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

См. также:

synchronizedObservableMap

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

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

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

K - тип обернутого ключа

V - тип обернутого значения

Параметры:

map - карта, которая будет "обернута" в синхронизированную карту.

Возвращает:

Синхронизированная версия наблюдаемой карты

С:

JavaFX 8.0

См. также:

emptyObservableMap

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

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

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

K - тип обернутого ключа

V - тип обернутого значения

Возвращает:

Пустая неизменяемая наблюдаемая карта

С:

JavaFX 8.0

См. также:

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 - Тип списка, который будет обернут

Возвращает:

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

См. также:

observableArrayList

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

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

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

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

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

E - Тип наблюдаемого объекта, который будет обернут

Параметры:

extractor - Преобразователь элементов в наблюдаемые объекты

Возвращает:

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

С момента:

JavaFX 2.1

См. также:

observableArrayList

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

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

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

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

Параметры:

items - Элементы, которые будут находиться в новом наблюдаемом списке массивов

Возвращает:

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

См. также:

observableArrayList

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

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

Параметры типа:: E - Тип списка, который будет обернут
Параметры:: col - Коллекция, содержимое которой должно быть добавлено в наблюдаемый список массивов
Возвращает:: новый созданный наблюдаемый список массивов

observableHashMap

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

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

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

concat

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

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

Параметры типа:: E - Тип списка, который будет обернут
Параметры:: lists - Списки для конкатенации
Возвращает:: новый наблюдаемый список массивов, конкатенированный из аргументов

unmodifiableObservableList

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

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

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

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

Параметры:

list - Наблюдаемый список, который будет обернут

Возвращает:

оберточный наблюдаемый список, который является неизменяемым

См. также:

checkedObservableList

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

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

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

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

Параметры:

list - Наблюдаемый список, который будет обернут

type - Тип элемента, который list разрешается содержать

Возвращает:

динамически безопасный вид указанного списка

См. также:

synchronizedObservableList

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

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

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

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

Параметры:

list - Список, который будет "оборачиваться" в синхронизированный список.

Возвращает:

Синхронизированная версия наблюдаемого списка

См. также:

emptyObservableList

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

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

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

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

Возвращает:

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

См. также:

singletonObservableList

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

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

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

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

Параметры:

e - Единственный элемент, который будет содержаться в этом одноэлементном наблюдаемом списке

Возвращает:

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

См. также:

unmodifiableObservableSet

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

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

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

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

Параметры:

set - Наблюдаемый набор, который будет обернут

Возвращает:

оберточный наблюдаемый набор, который является неизменяемым

С момента:

JavaFX 8.0

См. также:

checkedObservableSet

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

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

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

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

Параметры:

set - Наблюдаемый набор, который будет обернут

type - Тип элемента, который set разрешается содержать

Возвращает:

динамически безопасный вид указанного набора

С момента:

JavaFX 8.0

См. также:

synchronizedObservableSet

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

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

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

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

Параметры:

set - Набор, который будет "оборачиваться" в синхронизированный набор.

Возвращает:

Синхронизированная версия наблюдаемого набора

С момента:

JavaFX 8.0

См. также:

emptyObservableSet

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

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

Type Parameters:

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

Returns:

Пустое неизменяемое наблюдаемое множество

Since:

JavaFX 8.0

See Also:

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:

fill

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

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

Type Parameters:

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

Parameters:

list - список для заполнения

obj - объект для заполнения списка

See Also:

replaceAll

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

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

Type Parameters:

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

Parameters:

list - список, элементы которого будут заменены

oldVal - элемент, который будет заменён

newVal - замена

Returns:

true, если список был изменён

See Also:

reverse

public static void reverse(ObservableList list)

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

Parameters:

list - список, который будет инвертирован

See Also:

rotate

public static void rotate(ObservableList list, int distance)

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

Parameters:

list - список, который будет повернут

distance - расстояние поворота

See Also:

shuffle

public static void shuffle(ObservableList<?> list)

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

Parameters:

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

See Also:

shuffle

public static void shuffle(ObservableList list, Random rnd)

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

Parameters:

list - список, который будет перемешан

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

See Also:

sort

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

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

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

sort

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

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

Type Parameters:: T - тип элементов в этом списке
Parameters:: 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.