Класс 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 недействительным для всех последующих слушателей.

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