Package javax.sql.rowset

JDBC RowSet实现标准接口和基类。

See: 描述

接口摘要

接口	描述
CachedRowSet	接口， CachedRowSet所有标准的实现必须实现。
FilteredRowSet	这 FilteredRowSet所有标准的实现必须实现的标准接口。
JdbcRowSet	这 JdbcRowSet所有标准的实现必须实现的标准接口。
Joinable	1背景
JoinRowSet	的 JoinRowSet接口提供了一种结合相关数据从不同的 RowSet对象到一个 JoinRowSet对象机制，这是一个SQL JOIN。
Predicate	标准接口，所有 FilteredRowSet对象来描述他们的过滤器提供了框架。
RowSetFactory	一个接口，定义了一个工厂，以获得不同类型的 RowSet实现实现。
WebRowSet	那一 WebRowSet实现必须实现的标准接口。

类摘要

类	描述
BaseRowSet	一个抽象类提供了一个 RowSet对象及其基本功能。
RowSetMetaDataImpl	提供了用于设置和获得一个 RowSet对象的列的元数据信息的实现方法。
RowSetProvider	一个工厂的API，使应用程序能够获得 RowSetFactory实现，可以用来创建不同类型的 RowSet实现。

异常摘要

异常	描述
RowSetWarning	提供有关数据库的 SQLException警告设置 RowSet对象信息的延伸。

Package javax.sql.rowset Description

JDBC RowSet实现标准接口和基类。这个软件包中的接口和类，一个标准的 RowSet实现或实现或扩展。

表的内容

• 1.0 Package Specification
• 2.0 Standard RowSet Definitions
• 3.0 Implementer's Guide
• 4.0 Related Specifications
• 5.0 Related Documentation

1.0 Package Specification

这个包指定标准的JDBC RowSet接口五。五延长在JDBC 3规范中描述的 RowSet接口。可以预期的是，更专业的JDBC RowSet类型附加的定义将成为该技术的成熟。未来的定义应该被指定为使用继承相似，它是在本规范中使用的接口的方法。

注：这种封装形式为所有兼容JDBC RowSet实现提供基础的接口定义。供应商和更高级的开发人员打算提供自己的标准RowSet实现应该特别注意在规范接口的详细的断言。

2.0 Standard RowSet Definitions

• JdbcRowSet -在ResultSet对象可以用设置为JavaBeans组件的结果™包装。因此，一个JdbcRowSet对象可以是一个Bean任何工具可以安装应用程序是一个基于组件的体系结构的一部分。一个JdbcRowSet对象是连接RowSet对象，即它必须不断保持其连接到数据源使用JDBC技术支持的驱动程序（“JDBC驱动程序”）。此外，一个JdbcRowSet对象提供了一个完全更新和滚动在JDBC 3规范定义的表格数据结构。

• CachedRowSet™ - CachedRowSet对象是一个JavaBeans组件，™滚动、更新，可序列化的，一般断开其数据源。一个CachedRowSet对象通常包含一个结果集的行，但它也可以包含一个表格式的任何文件的行数，如电子表格。CachedRowSet实现必须使用SyncFactory管理和获得可插拔SyncProvider对象提供断开的RowSet对象与原始数据源之间的同步。一个典型的SyncProvider的实现依赖于JDBC驱动程序连接到特定数据源的获取。这一机制的进一步细节在javax.sql.rowset.spi包装规范探讨。

• WebRowSet - WebRowSet对象是一个扩展的CachedRowSet可以读取和格式良好的XML格式写一RowSet对象。这类所谓的XmlReader对象（的RowSetReader接口的扩展）读取XML格式的数据集。它调用一个对象（XmlWriter的RowSetWriter接口的扩展）写在XML格式的数据集。通过WebRowSet对象所需的读者和作家都在SyncProvider实现形式提供SyncFactory。为了确保良好的XML的使用，标准通用的XML模式定义和发布在 http://java.sun.com/xml/ns/jdbc/webrowset.xsd。

• FilteredRowSet - FilteredRowSet对象提供过滤功能的编程和可扩展的方式。有许多情况下，当一个RowSet object有需要提供内容过滤在不牺牲环境的断开，从而节省了创建到数据源的连接费用。这需要解决方案提供重量级的全面的SQL查询能力的差别，对便携式组件，更轻的方法。一个FilteredRowSet对象消耗的Predicate接口的一个实现，这可以在运行时定义一个过滤器。反过来，一个FilteredRowSet对象的任务是执行设置过滤器为入站和出站的读写操作。也就是说，所有的过滤器都可以被看作是双向的。没有定义标准的过滤器，但是，指定足够的力学，以允许任何所需的过滤器来实现。

• JoinRowSet - JoinRowSet接口描述了一种机制，关系可以是两个或两个以上的标准RowSet实现之间建立。任何数量的RowSet对象可以被添加到一个JoinRowSet对象提供RowSetobjects可以在SQL JOIN喜欢时尚相关。根据定义，SQL JOIN语句用于将包含两个数据（或更多）关系数据库表中基于共同的属性。通过建立并实施列匹配，一JoinRowSet对象建立关系RowSet实例不需要触摸原始数据源。

3.0 Implementer's Guide

兼容实现JDBC RowSet实现 必须遵循本说明书中描述的断言。按照该 Java Community Process条款，一个兼容性测试套件（TCK）可授权确保与标准的兼容。下面列出了一些标准的JDBC RowSet定义者的出发点。实施者也应该咨询实施指南在 javax.sql.rowset.spi包上 SyncProvider实现的准则。

• 3.1构造函数

  所有的RowSet实现必须提供一个无参数的构造函数。

• BaseRowSet类的作用3.2

  一个标准的JDBC RowSet实施必须实现一个或多个标准接口，在这个包中指定和可以延长BaseRowSet抽象类。例如，一个CachedRowSet实现必须实现CachedRowSet接口和扩展BaseRowSet抽象类。BaseRowSet类提供的标准架构上的所有RowSet实现应建立，无论在连接或断开环境存在的RowSet对象。的BaseRowSet抽象类提供任何RowSet实现其基本功能，包括物业的操作和事件通知，完全符合JavaBeans组件的要求。作为一个例子，在参考实现提供了所有的实现（包含在com.sun.rowset包）使用作为其实现的基础BaseRowSet类。

  下表说明了BaseRowSet抽象类提供的功能。

  Feature	Details
  Properties	Provides standard JavaBeans property manipulation mechanisms to allow applications to get and set RowSet command and property values. Refer to the documentation of the javax.sql.RowSet interface (available in the JDBC 3.0 specification) for more details on the standard RowSet properties.
  Event notification	Provides standard JavaBeans event notifications to registered event listeners. Refer to the documentation of javax.sql.RowSetEvent interface (available in the JDBC 3.0 specification) for more details on how to register and handle standard RowSet events generated by compliant implementations.
  Setters for a RowSet object's command	Provides a complete set of setter methods for setting RowSet command parameters.
  Streams	Provides fields for storing of stream instances in addition to providing a set of constants for stream type designation.

• 3.3连接行集的要求

  描述一个对象的JdbcRowSet RowSet 必须一直连接到原始数据源。该JdbcRowSet实现应该确保这个连接是由JDBC驱动程序设置。此外，RowSet对象的JdbcRowSet接口实现，因此在连接环境中操作不使用SyncFactory获得RowSetReader对象或RowSetWriter对象。他们可以放心地依靠JDBC驱动程序来满足他们的需求的一个潜在的可更新和可滚动的ResultSet实施存在的美德。

• 3.4断开数据集的要求

  断开连接的RowSet对象，如CachedRowSet对象，应该代表连接管理的一个SyncFactory提供SyncProvider对象。确保完全断开连接的语义，所有断开的RowSet对象必须确保数据源填充RowSet对象原有的连接被关闭，允许垃圾收集器回收和释放资源。的SyncProvider对象确保关键的JDBC性能维持以重新建立一个连接到数据源时，需要同步。断开连接的RowSet对象应确保没有多余的Connection保持引用的对象。

• RowSetMetaDataImpl的角色3.5

  的RowsetMetaDataImpl类是一个工具类，提供了RowSetMetaData接口的一个实现，用于连接和断开RowSet对象元数据提供标准的setter方法的实现。所有实现都可以自由使用这个标准实现，但不需要这样做。

• 3.6 rowsetwarning类

  的RowSetWarning类提供警告，可以设置RowSet实现。类似SQLWarning对象，RowSetWarning对象默默锁的方法产生的警告被抛出的对象。所有的RowSet实现应该确保这个链接时如果将生成警告，并确保警报可通过两JdbcRowSet接口或接口中定义的方法的getRowSetWarnings CachedRowSet。在已经被警告的一个getRowSetWarnings方法检索的方法，RowSetWarning getNextWarning可以调用它来检索可能被拴上任何警告。如果一个警告是回来了，getNextWarning可以调用它，等等，直到没有更多的警告。

• 3.7可连接的接口

  的Joinable接口提供连接和断开RowSet对象的能力被添加到在一个SQL JOIN JoinRowSet对象操作。一个RowSet对象，实现了Joinable界面可以设置匹配的列，检索匹配或不匹配的列，列。然后JoinRowSet对象可以使用RowSet对象的匹配列添加RowSet对象的基础。

• 3.8 rowsetfactory接口

  一个RowSetFactory实施必须提供。

4.0 Related Specifications

• JDBC 3.0 Specification
• XML Schema
• SyncML

5.0 Related Documentation

• JDBC RowSet Tutorial