Интерфейс 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 (см. пример в Predicate классе JavaDoc), 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, должны находиться между значениями 'Alpha' и 'Bravo' включительно в столбце 'columnName'. Если фильтр применяется к объекту FilteredRowSet, который не содержит данных, попадающих в диапазон фильтра, то строки не возвращаются.

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

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

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

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

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

5.0 Поведение строк вне фильтра

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

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