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

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