Пакет javax.sql.rowset

Стандартные интерфейсы и базовые классы для JDBC RowSet реализаций. В этом пакете содержатся интерфейсы и классы, которые стандартная RowSet реализация либо реализует, либо расширяет.

Содержание

• 1.0 Спецификация пакета
• 2.0 Определения стандартных RowSet
• 3.0 Руководство для разработчиков реализаций
• 4.0 Связанные спецификации
• 5.0 Связанная документация

1.0 Спецификация пакета

В этом пакете определены пять стандартных JDBC RowSet интерфейсов. Все пять расширяют интерфейс RowSet, описанный в спецификации JDBC 3.0. Ожидается, что по мере развития этой технологии появятся дополнительные определения более специализированных типов JDBC RowSet . Будущие определения должны быть определены как подинтерфейсы с использованием наследования, аналогично тому, как это используется в этой спецификации.

Примечание: Определения интерфейсов, предоставленные в этом пакете, образуют основу для всех совместимых JDBC RowSet реализаций. Поставщики и более опытные разработчики, намеревающиеся предоставить свои собственные совместимые RowSet реализации, должны уделить особое внимание утверждениям, подробно описанным в специфицирующих интерфейсах.

2.0 Определения стандартных RowSet

• JdbcRowSet - Обёртка вокруг ResultSet объекта, позволяющая использовать набор результатов как компонент JavaBeans™. Таким образом, JdbcRowSet объект может быть компонентом, который любой инструмент предоставляет для сборки приложения в рамках архитектуры, основанной на компонентах. Объект JdbcRowSet - это подключённый RowSet объект, то есть он должен постоянно поддерживать подключение к источнику данных с использованием драйвера, поддерживающего JDBC ("JDBC драйвер"). Кроме того, JdbcRowSet объект предоставляет полностью обновляемую и прокручиваемую табличную структуру данных, как определено в спецификации JDBC 3.0.
• CachedRowSet™ - CachedRowSet объект — это компонент JavaBeans™, который может прокручиваться, обновляться, сериализоваться и в целом отключён от источника данных. CachedRowSet объект обычно содержит строки из набора результатов, но он также может содержать строки из любого файла с табличной структурой, например, электронную таблицу. CachedRowSet реализации должны использовать SyncFactory для управления и получения подключаемых SyncProvider объектов, обеспечивающих синхронизацию между отключённым RowSet объектом и исходным источником данных. Обычно SyncProvider реализация полагается на JDBC драйвер для получения подключения к конкретному источнику данных. Более подробные сведения об этом механизме приведены в спецификации пакета javax.sql.rowset.spi.
• WebRowSet - WebRowSet объект — это расширение CachedRowSet , которое может читать и записывать RowSet объект в формате хорошо сформированного XML. Этот класс вызывает объект XmlReader (расширение интерфейса RowSetReader), чтобы прочитать набор строк в формате XML. Он вызывает объект XmlWriter (расширение интерфейса RowSetWriter), чтобы записать набор строк в формате XML. Читатель и писатель, требуемые WebRowSet объектами, предоставляются SyncFactory в виде реализаций SyncProvider. Для обеспечения правильного использования XML определён и опубликован стандартный универсальный XML-схема http://java.sun.com/xml/ns/jdbc/webrowset.xsd.
• FilteredRowSet - FilteredRowSet объект предоставляет функциональность фильтрации программно и расширяемым способом. Есть много случаев, когда RowSet object необходимо обеспечить фильтрацию своего содержимого, не жертвуя отключённой средой, тем самым экономя затраты на создание подключения к источнику данных. Решения этой задачи варьируются от предоставления полнофункциональных возможностей SQL запросов до портативных компонентов и более лёгких подходов. FilteredRowSet объект использует реализацию интерфейса Predicate, который может определить фильтр во время выполнения. В свою очередь, FilteredRowSet объект отвечает за применение набора фильтров для операций чтения и записи, как входных, так и выходных. То есть, все фильтры могут рассматриваться как двусторонние. Стандартные фильтры не определены; однако, указаны достаточные механизмы для реализации любых необходимых фильтров.
• JoinRowSet - Интерфейс JoinRowSet описывает механизм, с помощью которого можно установить отношения между двумя или более стандартными RowSet реализациями. Любое количество RowSet объектов может быть добавлено в JoinRowSet объект, если RowSet объекты могут быть связаны в стиле SQL JOIN. По определению, оператор SQL JOIN используется для объединения данных, содержащихся в двух (или более) таблицах реляционной базы данных на основе общего атрибута. Устанавливая и затем проверяя соответствия столбцов, объект JoinRowSet устанавливает отношения между RowSet экземплярами, не затрагивая исходный источник данных.

3.0 Руководство для разработчиков реализаций

Соответствующие реализации JDBC RowSet реализаций должны следовать утверждениям, описанным в этой спецификации. В соответствии с условиями Java Community Process, комплект тестирования совместимости (TCK) может быть лицензирован для обеспечения совместимости со спецификацией. Следующие абзацы описывают несколько отправных точек для разработчиков реализаций стандартных JDBC RowSet определений. Разработчики реализаций также должны обратиться к Руководству для разработчиков реализаций в пакете javax.sql.rowset.spi для получения руководства по реализации SyncProvider.