Интерфейс FilteredRowSet

public interface FilteredRowSet extends WebRowSet

Стандартный интерфейс, который должны реализовывать все стандартные реализации FilteredRowSet. Класс FilteredRowSetImpl предоставляет эталонную реализацию, которую при необходимости можно расширить. Также поставщик может реализовать собственную версию, реализовав этот интерфейс.

1.0 Предыстория

Иногда объекту RowSet необходимо обеспечить фильтрацию его содержимого. Одним из возможных решений является предоставление языка запросов для всех стандартных реализаций RowSet; однако такой подход непрактичен для облегчённых компонентов, например отключённых объектов RowSet. Интерфейс FilteredRowSet призван удовлетворить эту потребность, не предоставляя тяжеловесный язык запросов и необходимую для него обработку.

Стандартная реализация JDBC FilteredRowSet реализует интерфейсы RowSet и наследует класс CachedRowSet. Класс CachedRowSet предоставляет набор защищённых методов управления курсором, которые реализация FilteredRowSet может переопределить для поддержки фильтрации.

2.0 Совместное использование предиката

Если реализация FilteredRowSet совместно используется с помощью унаследованного метода createShared родительских интерфейсов, то Predicate следует совместно использовать без изменений всеми клонами экземпляра FilteredRowSet.

3.0 Использование

Реализовав Predicate (см. пример в документации JavaDoc класса Predicate), можно использовать FilteredRowSet, как описано ниже.

    FilteredRowSet frs = new FilteredRowSetImpl();
    frs.populate(rs);

    Range name = new Range("Alpha", "Bravo", "columnName");
    frs.setFilter(name);

    frs.next() // only names from "Alpha" to "Bravo" will be returned

В приведённом выше примере мы инициализируем объект Range, реализующий интерфейс Predicate. Этот объект задаёт следующие ограничения: все строки, возвращаемые или изменяемые этим объектом FilteredRowSet, должны содержать в столбце 'columnName' значения в диапазоне от 'Alpha' до 'Bravo' включительно. Если к объекту FilteredRowSet, не содержащему данных в пределах диапазона фильтра, применён фильтр, строки не возвращаются.

Эта инфраструктура позволяет комбинировать несколько классов, реализующих предикаты, чтобы добиться требуемого результата фильтрации без обработки языка запросов.

4.0 Обновление объекта FilteredRowSet

Предикат, заданный для объекта FilteredRowSet, применяется ко всем строкам объекта RowSet, чтобы управлять подмножеством строк объекта RowSet. Этот критерий определяет подмножество видимых строк, а также строки, которые можно изменять, удалять или вставлять.

Следовательно, предикат, заданный для объекта FilteredRowSet, следует считать двунаправленным, а установленный критерий — механизмом, определяющим все представления и обновления объекта FilteredRowSet. Любая попытка обновить FilteredRowSet с нарушением критерия приведёт к выбрасыванию объекта SQLException.

Критерий диапазона FilteredRowSet можно изменить, применив новый объект Predicate к экземпляру FilteredRowSet в любое время. Это возможно, если не обнаружено дополнительных ссылок на объект FilteredRowSet. Новый фильтр сразу влияет на применение критерия в объекте FilteredRowSet, а все последующие представления и обновления будут подчиняться аналогичным ограничениям.

5.0 Поведение строк, не попадающих под фильтр

Строки, не попадающие под фильтр, заданный для объекта FilteredRowSet, нельзя изменять, пока фильтр не будет удалён или не будет применён новый фильтр.

Кроме того, с источником данных синхронизируются только строки, попадающие в границы фильтра.