Класс ListChangeListener.Change<E>

public abstract static class ListChangeListener.Change<E>
extends Object

Представляет отчет о внесённых изменениях в ObservableList. Изменение может состоять из одного или нескольких фактических изменений и должно итерироваться с помощью вызова метода next(). Каждое изменение должно быть одним из следующих:

• Перестановки : в этом случае метод wasPermutated() возвращает true. Перестановка произошла в диапазоне между from (включительно) и to (исключительно) и может быть запрошена с помощью метода getPermutation(int).
• Добавление или удаление : в этом случае хотя бы один из методов wasAdded(), wasRemoved() возвращает true. Если оба метода возвращают true, метод wasReplaced() также вернёт true.

  Метод getRemoved() возвращает список элементов, которые были заменены или удалены из списка.

  Диапазон между from (включительно) и to (исключительно) обозначает подсписок списка, содержащий новые элементы. Обратите внимание, что это полуоткрытый интервал, поэтому если элементы не были добавлены, getFrom() равно getTo().

  Список добавленных элементов можно получить, вызвав getAddedSubList().

  Обратите внимание, что для поддержания корректных индексов отдельных изменений добавления/удаления эти изменения должны быть отсортированы по индексу from.

• Обновление : метод wasUpdated() возвращает true при изменении обновления. Все элементы между from (включительно) и to (исключительно) были обновлены.

Важно: Необходимо вызвать метод next() перед вызовом любого другого метода Change. То же самое относится и после вызова reset(). Единственный метод, который работает в любое время, это getList().

Типичный способ использования — наблюдать за изменениями в ObservableList для подключения или отключения (или добавления или удаления слушателя) или для поддержания какого-либо инварианта на каждом элементе в этом ObservableList. Распространённый шаблон кода для этого выглядит примерно так:

 ObservableList<Item> theList = ...;

 theList.addListener(new ListChangeListener<Item>() {
     public void onChanged(Change<Item> c) {
         while (c.next()) {
             if (c.wasPermutated()) {
                 for (int i = c.getFrom(); i < c.getTo(); ++i) {
                      //permutate
                 }
             } else if (c.wasUpdated()) {
                      //update item
             } else {
                 for (Item remitem : c.getRemoved()) {
                     remitem.remove(Outer.this);
                 }
                 for (Item additem : c.getAddedSubList()) {
                     additem.add(Outer.this);
                 }
             }
         }
     });

 }

Предупреждение: Этот класс напрямую обращается к исходному списку для получения информации об изменениях.
Это делает объект Change недействительным при возникновении другого изменения в списке.
По этой причине не рекомендуется использовать этот класс в другом потоке.
Это также означает, что исходный список нельзя изменять внутри слушателя, так как это сделает этот объект Change недействительным для всех последующих слушателей.

Примечание: в случае, если изменение содержит несколько изменений разных типов, эти изменения должны быть в следующем порядке: изменения перестановки, изменения добавления или удаления, изменения обновления . Это связано с тем, что изменения перестановок не могут следовать за изменениями добавления/удаления, так как они изменят положение добавленных элементов. С другой стороны, изменения обновления должны следовать за изменениями добавления/удаления, потому что они ссылаются на свои индексы на текущее состояние списка, что означает с применением всех изменений добавления/удаления.