Пакет 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 можно вызвать метод 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

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

• Учебник JDBC RowSet