Пакет 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://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 Specification
• XML Schema

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

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