Пакет 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 может быть компонентом Bean, который любой инструмент может предоставить для сборки приложения в рамках архитектуры на основе компонентов. Объект 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://xmlns.jcp.org/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.

• 3.1 Конструктор

  Все RowSet реализации должны предоставлять конструктор без аргументов.

• 3.2 Роль класса BaseRowSet

  Соответствующая реализации JDBC RowSet должна реализовывать один или несколько стандартных интерфейсов, указанных в этом пакете, и может расширять абстрактный класс BaseRowSet. Например, реализация CachedRowSet должна реализовывать интерфейс CachedRowSet и расширять абстрактный класс BaseRowSet. Класс BaseRowSet предоставляет стандартную архитектуру, на которой должны строиться все реализации RowSet, независимо от того, существуют ли объекты RowSet в подключённой или отключённой среде. Абстрактный класс BaseRowSet предоставляет любой реализации RowSet свою базу функциональности, включая управление свойствами и уведомления об событиях, полностью соответствующие требованиям компонентов JavaBeans. В качестве примера, все реализации, представленные в эталонных реализациях (содержащихся в пакете com.sun.rowset), используют класс BaseRowSet в качестве основы для своих реализаций.

  Следующая таблица иллюстрирует функции, которые предоставляет абстрактный класс BaseRowSet.

  Функции в BaseRowSet

  Функция	Подробности
  Свойства	Предоставляет стандартные механизмы управления свойствами JavaBeans, чтобы приложения могли получать и устанавливать значения команд и свойств RowSet. Дополнительную информацию о стандартных свойствах RowSet см. в документации интерфейса javax.sql.RowSet (доступной в спецификации JDBC 3.0).
  Уведомления об событиях	Предоставляет стандартные уведомления об событиях JavaBeans для зарегистрированных слушателей событий. Дополнительную информацию о том, как регистрировать и обрабатывать стандартные события RowSet, генерируемые соответствующими реализациями, см. в документации интерфейса javax.sql.RowSetEvent (доступной в спецификации JDBC 3.0).
  Установщики для команды объекта RowSet	Предоставляет полный набор методов-установщиков для задания параметров команды RowSet.
  Потоки	Предоставляет поля для хранения экземпляров потоков, а также набор констант для обозначения типа потока.

• 3.3 Требования к подключенному RowSet

  JdbcRowSet описывает объект RowSet, который должен всегда быть подключён к исходному источнику данных. Реализации JdbcRowSet должны гарантировать, что это подключение предоставляется исключительно драйвером JDBC. Кроме того, объекты RowSet, которые являются реализациями интерфейса JdbcRowSet и, следовательно, работают в подключённой среде, не используют SyncFactory для получения объекта RowSetReader или объекта RowSetWriter. Они могут безопасно полагаться на драйвер JDBC для обеспечения своих потребностей благодаря наличию базовой реализаций ResultSet для обновления и прокрутки.

• 3.4 Требования к отключенному RowSet

  Объект отключённого RowSet объекта, такого как CachedRowSet объект, должен делегировать управление подключением объекту SyncProvider, предоставляемому SyncFactory. Для обеспечения полной отключённой семантики все отключенные объекты RowSet должны гарантировать, что исходное подключение к источнику данных для заполнения объекта RowSet закрыто, чтобы позволить сборщику мусора восстановить и освободить ресурсы. Объект SyncProvider гарантирует, что критически важные свойства JDBC сохраняются для повторного установления подключения к источнику данных, когда требуется синхронизация. Отключенный объект RowSet должен, следовательно, гарантировать, что на объекте Connection не остаётся лишних ссылок.

• 3.5 Роль RowSetMetaDataImpl

  Класс RowsetMetaDataImpl — это служебный класс, который предоставляет реализацию интерфейса RowSetMetaData, предоставляя стандартные реализации методов установщиков метаданных для подключённых и отключённых объектов RowSet. Все реализации могут свободно использовать эту стандартную реализацию, но не обязаны это делать.

• 3.6 Класс RowSetWarning

  Класс RowSetWarning предоставляет предупреждения, которые можно задать для реализаций RowSet. Подобно объектам SQLWarning, объекты RowSetWarning молча цепляются к объекту, метод которого вызвал выброс предупреждения. Все реализации RowSet должны обеспечить, чтобы эта цепочка произошла, если генерируется предупреждение, а также обеспечить доступность предупреждений через метод getRowSetWarnings, определённый в интерфейсе JdbcRowSet или интерфейсе CachedRowSet. После того, как предупреждение было получено с помощью одного из методов getRowSetWarnings, можно вызвать метод RowSetWarning getNextWarning на нём, чтобы получить любые предупреждения, которые могут быть прикреплены к нему. Если возвращается предупреждение, можно вызвать getNextWarning и так далее, пока не закончатся предупреждения.

• 3.7 Интерфейс Joinable

  Интерфейс Joinable предоставляет как подключённым, так и отключённым объектам RowSet возможность добавления в объект JoinRowSet в операции SQL JOIN. Объект RowSet, реализовавший интерфейс Joinable, может задать столбец совпадения, получить столбец совпадения или сбросить столбец совпадения. Объект JoinRowSet может затем использовать столбец совпадения объекта RowSet в качестве основы для добавления объекта RowSet.

• 3.8 Интерфейс RowSetFactory

  Реализация RowSetFactory должна быть предоставлена.

4.0 Связанные спецификации

• Спецификация JDBC 4.3
• XML Schema

5.0 Связанная документация

• Руководство по JDBC RowSet