Пакет 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.

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

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

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

  Соответствующая реализация JDBC RowSet должна реализовывать один или несколько стандартных интерфейсов, указанных в этом пакете, и может расширять абстрактный класс BaseRowSet. Например, реализация CachedRowSet должна реализовывать интерфейс CachedRowSet и расширять абстрактный класс BaseRowSet. Класс BaseRowSet предоставляет стандартную архитектуру, на основе которой должны строиться все реализации RowSet, независимо от того, существуют ли объекты RowSet в подключенном или отключенном окружении. Абстрактный класс BaseRowSet предоставляет любой реализации RowSet базовые функциональные возможности, включая управление свойствами и уведомления о событиях, которые полностью соответствуют требованиям компонентов JavaBeans. Например, все реализации, предоставленные в эталонных реализациях (содержащихся в пакете com.sun.rowset), используют класс 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 3.0 Specification
• XML Schema
• SyncML

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

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