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

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