Пакет javax.sql.rowset

Стандартные интерфейсы и базовые классы для JDBC RowSet реализации.

См.: Описание

Сводка интерфейса

Интерфейс	Описание
CachedRowSet	Интерфейс, что все стандартные реализации CachedRowSet должен реализовать.
FilteredRowSet	Стандартный интерфейс, что все стандартные реализации FilteredRowSet должен реализовать.
JdbcRowSet	Стандартный интерфейс, что все стандартные реализации JdbcRowSet должен реализовать.
Joinable	1.0 Фон
JoinRowSet	JoinRowSet интерфейс обеспечивает механизм для того, чтобы он объединил связанные данные от различного RowSet объекты в одного JoinRowSet объект, который представляет SQL JOIN.
Предикат	Стандартный интерфейс, который служит основой для всех FilteredRowSet объекты описать их фильтры.
RowSetFactory	Интерфейс, который определяет реализацию фабрики, которая используется, чтобы получить различные типы RowSet реализации.
WebRowSet	Стандартный интерфейс, что все реализации a WebRowSet должен реализовать.

Сводка класса

Класс	Описание
BaseRowSet	Абстрактный class, обеспечивающий a RowSet объект с его основной функциональностью.
RowSetMetaDataImpl	Обеспечивает реализации для методов, которые устанавливают и получают информацию метаданных о a RowSet столбцы объекта.
RowSetProvider	API фабрики, который позволяет приложениям получить a RowSetFactory реализация, которая может использоваться, чтобы создать различные типы RowSet реализации.

Сводка исключения

Исключение	Описание
RowSetWarning	Расширение SQLException это предоставляет информацию о наборе предупреждений базы данных на RowSet объекты.

Пакет 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, который позволяет использовать набор результатов в качестве компонента ^JavaBeansTM. Таким образом объектом JdbcRowSet может быть Боб, который любой инструмент делает доступным для того, чтобы собрать приложение как часть компонентно-ориентированной архитектуры. Объект JdbcRowSet является соединенным RowSet объект, то есть, это должно непрерывно поддерживать свое соединение с его источником данных, используя поддерживающий технологию драйвер JDBC ("драйвер JDBC"). Кроме того, a JdbcRowSet объект обеспечивает полностью обновляемую и структуру табличных данных с возможностью прокрутки как определено в JDBC 3.0 спецификации.

• CachedRowSet™ - объект CachedRowSet является компонентом ^JavaBeansTM, который с возможностью прокрутки, обновляем, сериализуем, и обычно разъединенный от источника его данных. Объект CachedRowSet обычно содержит строки от набора результатов, но он может также содержать строки от любого файла с табличным форматом, такие как электронная таблица. реализации CachedRowSet должны использовать SyncFactory, чтобы управлять и получить сменный SyncProvider объекты обеспечить синхронизацию между разъединенным RowSet возразите и инициирующий источник данных. Обычно a SyncProvider реализация полагается на драйвер JDBC, чтобы получить связь к определенному источнику данных. Более подробная информация об этом механизме обсуждается в javax.sql.rowset.spi спецификация пакета.

• WebRowSet - A WebRowSet объект является расширением CachedRowSet, который может считать и записать a RowSet объект в хорошо сформированном формате XML. Этот class вызывает 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-запроса полного масштаба, к переносимым компонентам, к более легким подходам. A FilteredRowSet объект использует реализацию Predicate интерфейс, который может определить фильтр во время выполнения. Поочередно, a FilteredRowSet для объекта определяют задачу с осуществлением фильтра набора и для входящих и для исходящих операций чтения и операций записи. Таким образом, все фильтры можно рассмотреть как двунаправленные. Никакие стандартные фильтры не определяются; однако, достаточная механика определяются, чтобы разрешить любому необходимому фильтру быть реализованным.

• JoinRowSet - Интерфейс JoinRowSet описывает механизм, которым отношения могут быть установлены между двумя или больше стандартами RowSet реализации. Любое число объектов RowSet может быть добавлено к объекту JoinRowSet, если объекты RowSet могут быть связаны в SQL JOIN как вид. По определению оператор JOIN SQL используется, чтобы объединить данные, содержавшиеся в два (или больше) таблицы реляционной базы данных, основанные на общем атрибуте. Устанавливая и затем осуществляя соответствия столбца, объект JoinRowSet устанавливает отношения между экземплярами RowSet без потребности коснуться инициирующего источника данных.

3.0 Руководство разработчика

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

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

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

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

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

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

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

• 3.3 Соединенные Требования RowSet

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

• 3.4 Разъединенные Требования RowSet

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

• 3.5 Роль RowSetMetaDataImpl

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

• 3.6 Класс RowSetWarning

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

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

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

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

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

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

• JDBC 3.0 Спецификации
• XML-схема
• SyncML

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

• JDBC Учебное руководство RowSet