接口 | 描述 |
---|---|
CachedRowSet |
CachedRowSet的所有标准
CachedRowSet 必须实现的接口。
|
FilteredRowSet |
FilteredRowSet的所有标准
FilteredRowSet 必须实现的标准接口。
|
JdbcRowSet |
JdbcRowSet的所有标准
JdbcRowSet 必须实现的标准接口。
|
Joinable |
1.0背景
|
JoinRowSet |
JoinRowSet 接口提供了将不同
RowSet 对象的相关数据
RowSet 到一个
JoinRowSet 对象中的机制,该对象表示SQL
JOIN 。
|
Predicate |
为所有
FilteredRowSet 对象提供
FilteredRowSet 来描述其过滤器的标准接口。
|
RowSetFactory |
一个定义工厂实现的接口,用于获取不同类型的
RowSet 实现。
|
WebRowSet |
WebRowSet的所有
WebRowSet 必须实现的标准接口。
|
类 | 描述 |
---|---|
BaseRowSet |
一个提供
RowSet 对象及其基本功能的抽象类。
|
RowSetMetaDataImpl |
提供有关设置和获取关于
RowSet 对象列的元数据信息的方法的实现。
|
RowSetProvider |
工厂API,使应用程序能够获得
RowSetFactory 实现,可将用于产生不同类型的
RowSet 实现。
|
异常 | 描述 |
---|---|
RowSetWarning |
SQLException的
SQLException ,提供有关在
RowSet 对象上设置的数据库警告的信息。
|
RowSet
实现的标准接口和基类。
此包包含标准RowSet
实现实现或扩展的接口和类。
RowSet
接口。
所有五个延长RowSet在JDBC 3.0说明书中描述的接口。
随着这项技术的成熟,预计会出现更专门的JDBC RowSet
类型的额外定义。
未来的定义应该使用与本规范中使用的方式类似的继承来指定为子接口。
注意:此包中提供的接口定义构成了所有兼容的JDBC RowSet
实现的基础。 要提供自己的兼容性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的扩展 ,可以以格式良好的XML格式读写RowSet
对象。 此类调用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
接口的实现, 可以在运行时定义一个过滤器。 反过来, FilteredRowSet
对象的任务是强制执行入站和出站读写操作的设置过滤器。 也就是说,所有的滤波器都可以被认为是双向的。 没有定义标准过滤器; 然而,指定足够的力学来允许实现任何所需的过滤器。 JoinRowSet
- JoinRowSet接口描述了一种机制,通过该机制可以在两个或多个标准RowSet
实现之间RowSet
关系。 任何数量的RowSet对象都可以添加到JoinRowSet对象中,前提是RowSet对象可以与SQL JOIN相似。 根据定义,SQL JOIN语句用于根据公共属性组合包含在两个( 或多个 )关系数据库表中的数据。 通过建立和然后才执行匹配的列中,JoinRowSet对象建立RowSet个实例之间的关系,而无需触摸原始数据源。 RowSet
实现必须遵循本规范中描述的断言。
根据条款Java Community Process ,测试兼容性套件(TCK)可以被授权,以确保与规范的兼容性。
以下段落概述了标准JDBC RowSet
定义的实现者的一些起点。
实施者也应征询实施者指南在javax.sql.rowset.spi包的准则SyncProvider
个实现。
所有RowSet
实现都必须提供无参数的构造函数。
BaseRowSet
类的作用 兼容的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 standardRowSet
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.
JdbcRowSet
描述了必须始终连接到始发数据源的RowSet
对象。 JdbcRowSet的JdbcRowSet
应该确保此连接仅由JDBC驱动程序提供。 而且, RowSet
对象是JdbcRowSet JdbcRowSet
实现,因此在连接的环境中运行,不使用SyncFactory
来获取RowSetReader
对象或RowSetWriter
对象。 借助于底层可更新和可滚动的ResultSet
实现,他们可以安全地依靠JDBC驱动程序来提供他们的需求。
断开连接的RowSet
对象,如CachedRowSet
对象, 应该委托连接管理到SyncProvider
由所提供的对象SyncFactory
。 为了确保完全断开连接的语义,所有断开连接的RowSet
对象必须确保关闭数据源的原始连接以填充RowSet
对象,以允许垃圾收集器恢复和释放资源。 SyncProvider
对象确保保持关键的JDBC属性,以便在需要同步时重新建立与数据源的连接。 断开连接的RowSet
因此对象应确保没有多余的引用保持在Connection
对象。
RowsetMetaDataImpl
类是一个实用程序类,它提供RowSetMetaData 接口的实现,为连接和断开的RowSet
对象的元数据提供标准的setter方法实现。 所有实现都可以自由使用此标准实现,但不需要这样做。
RowSetWarning
类提供可在RowSet
实现上设置的警告。 类似于SQLWarning对象, RowSetWarning
对象被静默地链接到方法引发警告的对象。 所有RowSet
实现应确保在生成警告时发生此链接,并确保通过JdbcRowSet
接口或CachedRowSet
接口中定义的getRowSetWarnings
方法CachedRowSet
警告。 在使用getRowSetWarnings
方法之一检索到警告后,可以调用RowSetWarning
方法getNextWarning
以检索可能链接的任何警告。 如果返回警告,可以调用getNextWarning
,直到没有更多的警告。
Joinable
接口提供连接和断开的RowSet
对象,具有在SQL JOIN
操作中添加到JoinRowSet
对象的功能。 甲RowSet
已经实现对象Joinable
接口可以设置匹配列,获取匹配列或取消设置匹配列。 一个JoinRowSet
对象可以使用RowSet
对象的匹配列作为添加RowSet
对象的基础。
一个RowSetFactory
必须提供实现。