Интерфейс 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 class 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, не могут быть изменены до тех пор, пока фильтр не будет удалён или не будет применён новый фильтр.

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