compact3

javax.sql.rowset

Interface CachedRowSet

All Superinterfaces:

AutoCloseable， Joinable， ResultSet， RowSet， Wrapper

All Known Subinterfaces:

FilteredRowSet， JoinRowSet， WebRowSet

public interface CachedRowSet
extends RowSet, Joinable

接口， CachedRowSet所有标准的实现必须实现。

由甲骨文公司提供的CachedRowSet接口的参考实现是一个标准的实施。开发人员可以使用此实现，就像它是一样的，他们可以扩展它，或者他们可以选择自己编写这个接口的实现。

一个CachedRowSet对象是用于缓存内存中的数据行的行的容器，可以不总是被连接到数据源的操作。此外，它是一个JavaBeans™部件，滚动，更新，和序列化。一个CachedRowSet对象通常包含一个结果集的行，但它也可以包含一个表格式的任何文件的行数，如表。参考实现只支持从一个ResultSet对象获取数据，但开发商可以延长SyncProvider实现提供访问其他表格数据源。

应用程序可以修改一个CachedRowSet对象的数据，而这些修改可以被传播回数据源。

一个CachedRowSet对象是断开的行集，这意味着它使用一个数据源只是简单地连接。它连接到它的数据源，而它是读取数据来填充自己的行，而它又是传播回其基本数据源。剩下的时间，一个CachedRowSet对象是断开的，包括在其数据被修改。被断开，使RowSet对象，因此更瘦更容易传递到另一个组件。例如，一个断开的RowSet对象可以被序列化，通过导线到瘦客户端如个人数字助理（PDA）。

1创建一个CachedRowSet对象

下面这行代码使用默认构造函数的实现提供参考 CachedRowSet（RI）来创建一个默认的 CachedRowSet对象。

CachedRowSetImpl CRS =新cachedrowsetimpl()；

这个新 CachedRowSet对象将其属性设置为一个 BaseRowSet对象，默认性能，此外，它会有一个 RIOptimisticProvider对象作为其同步提供者。 RIOptimisticProvider，一个 SyncProvider实现包括在RI，是默认的供应商， SyncFactory单将供应的时候没有同步提供程序指定的。

一个SyncProvider对象提供了一个CachedRowSet对象与读者（一RowSetReader对象）用于从数据源填充数据本身的读取数据。读者可以从ResultSet对象或从一个表格式的文件中读取数据。一个SyncProvider对象还提供了一个作家（一RowSetWriter对象）同步的任何修改的CachedRowSet对象的数据，它是在基础数据源的数据断开。

可以实施一个作家，以行使不同程度的照顾，在检查冲突，并在避免他们。（冲突发生时，数据源中的值已在数据集稠密的本身价值。改变）的RIOptimisticProvider执行将有很少或没有冲突，因此没有锁。更新数据源对象的值从CachedRowSet只有不存在冲突。可以实现其他作者，使他们总是写修改后的数据的数据源，它可以通过不检查冲突或在频谱的另一端，通过设置锁足以防止数据源中的数据被改变。还有一些作者的实现可以介于两者之间。

一个CachedRowSet对象可以使用已与SyncFactory单身注册任何SyncProvider实施。应用程序可以找到SyncProvider已实现通过调用下面这行代码注册。

java.util.enumeration商= syncfactory。getregisteredproviders()；

有一CachedRowSet对象指定将使用这两种方式SyncProvider对象。

• 在下面这行代码创建的对象，CachedRowSet CrS2初始化默认值，除了其SyncProvider对象是一个指定的constructor
  提供实施的名字。

  CachedRowSetImpl CrS2 =新CachedRowSetImpl（“COM。弗莱德。供应商。highavailabilityprovider”）；

• 使用CachedRowSet方法setSyncProvider
  以下代码行重置CRS SyncProvider对象设置的SyncProvider，CachedRowSet对象创建默认构造函数。

  CRS。setsyncprovider（“COM。弗莱德。供应商。highavailabilityprovider”）；

看到更多的细节 SyncFactory和 SyncProvider评论。

2检索数据从一个CachedRowSet对象

检索数据从一个 CachedRowSet对象使用getter方法从 ResultSet接口继承。下面的例子，其中 crs是 CachedRowSet对象，演示了如何遍历行，每一行中检索列值。第一个例子使用的getter方法，采取一列数的版本；第二例使用以列名的版本。列数一般用在 RowSet对象的命令的形式是 SELECT * FROM TABLENAME；列名时最常用的命令指定列名称。

而（CRS。next()）{字符串CRS GetString（1）；int id = CRS getInt（2）；CLOB评论= CRS getclob（3）；短部=学分获取（4）；系统。出来。println（名称+“”+编号+“”+评论+“”+部）；}

而（CRS。next()）{字符串CRS GetString（“名”）；int id = CRS。getInt（“ID”）；CLOB评论= CRS。getclob（“com”）；短部=学分获取（“部”）；系统。出来。println（名称+“”+编号+“”+评论+“”+部）；}

2.1检索RowSetMetaData

应用程序可以通过一个 RowSetMetaData对象调用 ResultSetMetaData和 RowSetMetaData方法得到关于一个 CachedRowSet对象的列的信息。下面的代码片段，其中CRS是一 CachedRowSet对象，说明了过程。第一行创建了一个与CRS有关栏目信息 RowSetMetaData对象。方法 getMetaData，从 ResultSet接口继承，返回一个 ResultSetMetaData对象，是投到 RowSetMetaData对象之前被分配给变量RSMD。第二行发现JRS有多少列，和第三号线的JDBC类型存储在 jrs第二列值。

rowsetmetadata RSMD =（rowsetmetadata）getmetadata() CRS；int数= RSMD。getcolumncount()；int类型= RSMD getcolumntype（2）；

的 RowSetMetaData界面不同于两方面的 ResultSetMetaData接口。

• 它包括二传方法：一RowSet对象使用这些方法时，它的内部填充了从不同的ResultSet对象数据。
• 它包含较少的吸气剂方法：一些ResultSetMetaData方法不适用于RowSet对象。例如，方法检索列值是否可写或只读不适用，因为所有的RowSet对象的列将可写或只读，这取决于数据集是可更新的或不。

注：为了返回一个 RowSetMetaData对象，实现必须重写定义在 java.sql.ResultSet的 getMetaData()方法返回一个对象 RowSetMetaData。

3更新CachedRowSet对象

更新 CachedRowSet对象类似于更新 ResultSet对象，但由于该行没有连接到数据源，当它被更新，它必须在它的底层数据源变化效果的一个额外的步骤。调用方法 updateRow或 insertRow后，一 CachedRowSet对象还必须调用方法 acceptChanges有写入数据源的更新。下面的例子中，其光标是在 CachedRowSet对象CRS一行，显示需要更新当前行中的列值的代码和另外两 RowSet更新对象的基础数据源。

CRS updateshort（3，58）；CRS updateint（4，150000）；updaterow() CRS；acceptchanges() CRS；

下面的例子演示了移动到插入行、插入行上建立一个新的列，插入的行集，然后调用该方法acceptChanges添加新行的基础数据源。注意的getter方法，更新方法可采取任何列的索引或列名称指定的列的作用。

movetoinsertrow() CRS；CRS。updatestring（“名”、“莎士比亚”）；CRS。updateint（“身份证”，10098347）；CRS。updateshort（“年龄”，58）；CRS。updateint（“萨尔”150000）；insertrow() CRS；movetocurrentrow() CRS；acceptchanges() CRS；

注：在insertRow()方法插入一个CachedRowSet对象的插入行的内容是实现定义。为CachedRowSet接口的参考实现，插入新的一行紧跟当前行，但它可以实现在任何其他的地方插入新的行。

另一个关于这些例子说明的是如何使用的方法acceptChanges。正是这种方法中CachedRowSet对象返回到基础数据源的变化，呼吁RowSet对象内部的作家写更改数据源。要做到这一点，作者必须承担费用，建立一个与该数据源的连接。前两段代码调用的方法acceptChanges后立即调用updateRow或insertRow。然而，当有人改变了多行，更有效的是后updateRow和insertRow所有调用已叫acceptChanges。如果acceptChanges称只有一次，只有一个连接需要建立。

4更新基础数据源

时执行的方法 acceptChanges， CachedRowSet对象的作家，一个 RowSetWriterImpl对象，称为幕后写的行集到基础数据源的变化。作者实现了对数据源的连接并对其进行更新。

作者通过对SyncProvider接口的一个实现了，在1节讨论的，“创造一个CachedRowSet对象。”默认的参考实现供应商，RIOptimisticProvider，有作家实现乐观并发控制机制。那就是，它保持在底层数据库没有锁，数据集是从数据库断开连接和简单的检查，看看是否有任何冲突之前对数据源的数据写入。如果有任何冲突，它不会将任何东西写入数据源。

由SyncProvider类提供读/写设备是可插拔的，允许数据检索的定制和更新。如果不同的并发控制机制是需要的，不同的实施SyncProvider可以插入使用方法setSyncProvider。

为了使用乐观并发控制程序，该RIOptismisticProvider既保持其当前值和原始值（它有立即的当前值，前值）。请注意，如果没有修改，在RowSet对象的数据，它的当前值和原始值是相同的，都是价值观的RowSet对象最初是稠密的。然而，一旦在RowSet对象的任何价值观已经改变，当前值与原始值会有所不同，但在这个阶段，原有的价值观仍然是初始值。任何随后的变化在RowSet对象数据，其原始值和当前值会有所不同，但其原始值，将以前的电流值。

跟踪原始值允许作家比较RowSet对象的原始值与数据库中的值。如果数据库中的值不同于RowSet对象的原始值，这意味着数据库中的值被改变，有冲突。是否一个作家检查冲突，什么程度的检查它，以及它如何处理冲突都取决于它是如何实现的。

5注册和通知听众

被JavaBeans组件，所有的行集参与JavaBeans事件模型，继承的方法注册监听器，通知他们从 BaseRowSet类的变化。一个 CachedRowSet目标听众的一个组成部分，要有行集中的更改通知。例如，如果一个 CachedRowSet对象包含查询的结果，这些结果显示，说，一张桌子和一个条形图，表和条形图可以注册为该行让他们可以自己更新以反映变化的听众。成为听众的表和条形图的类必须实现接口的 RowSetListener。然后他们可以加入到听众的 CachedRowSet对象的列表，如在下面的几行代码说明。

CRS addrowsetlistener（表）；CRS。addrowsetlistener（图）；

每个 CachedRowSet方法移动光标或更改数据的变化也通知注册的监听器，所以 table和 barGraph将在 crs变更通知。

6将数据传递给瘦客户机

一使用 CachedRowSet对象的主要原因是应用程序的不同组件之间传递数据。因为它是可序列化的，一 CachedRowSet对象可以使用，例如，发送一个由企业JavaBeans组件运行在服务器环境中通过网络向客户端运行在Web浏览器中执行的查询结果。

而CachedRowSet对象是断开的，它可以比具有相同的数据ResultSet对象要瘦。因此，它可以适用于发送数据到客户端如PDA，它是使用JDBC驱动程序由于资源限制或安全考虑不合适。因此，一个CachedRowSet对象提供了一种手段，“行”而不需要实现完整的JDBC API。

7滚动和更新

为 CachedRowSet对象的第二个主要的用途是提供滚动和 ResultSet对象不提供这些能力本身的更新。换句话说，一个 CachedRowSet对象可以用来增加一个JDBC技术的能力，使驾驶员（以下简称“JDBC驱动程序”）当数据库不提供滚动和更新支持。要实现使非scrollble和只读 ResultSet对象滚动和更新的影响，程序员只需要创建一个对象， ResultSet CachedRowSet填充对象的数据。这是在下面的代码片段显示，在 stmt是 Statement对象。

连接数据库为支撑。executeQuery（“SELECT * FROM employees”）；CachedRowSetImpl CRS =新cachedrowsetimpl()；CRS填充（RS）；

对象crs现在包含数据从表EMPLOYEES，只是为对象rs呢。不同的是，crs光标可以向前，向后，或一个特定的行，即使rs游标只能向前走。此外，即使rs不是因为默认crs是可更新的，一个CachedRowSet对象是滚动和更新。

总之，一个CachedRowSet对象可以被认为是一个断开的行集被缓存的数据源的一个外。瘦和序列化，它可以很容易地通过电线发送，它非常适合于发送数据到客户端。然而，一个CachedRowSet对象也有局限性：它是由数据可以存储在内存在一个时间量规模有限。

8获取通用数据访问

CachedRowSet类的另一个优点是它可以使检索和存储从其他比关系数据库数据源的数据。一个行集的读者能够读和从任何表格数据源的数据填充数据集，包括一个电子表格或平面文件。因为一个 CachedRowSet对象及其元数据可以从头开始创建一个组件，作为一个工厂的行集可以使用这个能力来创建一个数据集包含非SQL数据源的数据。不过，可以预期的是，大部分的时间， CachedRowSet对象将包含了使用JDBC API SQL数据库获取数据。

9设置属性

保持所有行集属性的集合，它通常会使用工具。的数量和性质的行集有种会有所不同，这取决于数据集和它是如何获得的数据。例如，行集，得到他们的数据从一个 ResultSet对象需要设置，使数据库连接的性能要求。如果一个数据集使用 DriverManager设施进行连接，需要设置JDBC URL标识相应的驱动程序的属性，它需要设置为用户名和密码的性质。如果，另一方面，该行以 DataSource对象来连接，这是首选的方法，它不需要设置JDBC URL属性。相反，它需要为数据源的逻辑名称、用户名和密码设置属性。

注：为了使用DataSource对象建立连接，这DataSource对象必须有一个命名服务，使用java命名和目录接口（JNDI）API™注册。此注册通常是由一个在系统管理员的容量中扮演的人所做的。

为了能够从一个数据库中的数据填充数据集本身，需要设置一个命令属性。此属性是一个查询，是一个PreparedStatement对象，它允许查询是在运行时设置参数占位符，而不是设计时间。设置这些参数值的占位符，一个数据集提供的设置每个数据类型值的setter方法，类似的PreparedStatement界面提供的setter方法。

下面的代码片段说明了如何CachedRowSet对象crs可能命令属性设置。请注意，如果一个工具用于设置属性，这是该工具将使用的代码。

    crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS " +
                   "WHERE CREDIT_LIMIT > ? AND REGION = ?");
 

的值将被用于设置命令的占位符参数包含在RowSet对象的params领域，这是一个Vector对象。的CachedRowSet类提供了一套在params场设置元素的setter方法。下面的代码片段演示了在前面的示例中设置查询中的两个参数。

CRS setint（1，5000）；CRS。如果（2，“西”）；

现在的params领域包含两个元素，每个数组元素的两个长。第一个元素是参数号；第二个元素是要设置的值。在这种情况下，params的第一要素是1，5000，第二元件2，"West"。当应用程序调用的方法execute，它会调用这个RowSet对象的读者，这将反过来调用它的readData方法。作为其实现的一部分，readData将获得价值params并使用它们来设置命令参数的占位符。下面的代码片段了读者这样一个理念，获得Connection对象con后。

    PreparedStatement pstmt = con.prepareStatement(crs.getCommand());
    reader.decodeParams();
    // decodeParams figures out which setter methods to use and does something
    // like the following:
    //    for (i = 0; i < params.length; i++) {
    //        pstmt.setObject(i + 1, params[i]);
    //    }
 

在这一点上，对crs命令查询"SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS WHERE CREDIT_LIMIT > 5000 AND REGION = "West"。在readData方法执行此命令下面这行代码，它将数据从rs，填充crs。

     ResultSet rs = pstmt.executeQuery();
 

前面的代码片段给幕后有什么想法；他们不会出现在一个应用程序，而不调用方法如readData和decodeParams。相反，下面的代码片段显示一个应用程序可以做什么。它集数据集的命令，设置命令的参数，并执行命令。简单地通过调用execute方法，crs填充与请求的数据从表CUSTOMERS。

    crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" +
                   "WHERE CREDIT_LIMIT > ? AND REGION = ?");
    crs.setInt(1, 5000);
    crs.setString(2, "West");
    crs.execute();
 

10分页数据

因为 CachedRowSet对象存储在内存中的数据，它可以包含在任何一个时间数据量的可用内存量确定。为了绕过这个限制，一个 CachedRowSet对象可以在数据块的一个 ResultSet对象中检索数据，称为页。利用这种机制，一个应用程序集的行数应包括使用方法 setPageSize在页。换言之，如果页面大小被设置为五，一个五行的数据将从一次从数据源中取出。应用程序还可以选择设置一次可以获取的最大行数。如果设置为零的最大行数，或没有设置最大行数，则可以在一个时间段中获取的行数没有限制。

在属性被设置，该CachedRowSet对象必须填充数据的使用方法，populate或方法execute。下面的代码演示如何使用该方法populate。注意，这个版本的方法需要两个参数，一个ResultSet手柄和从该行开始ResultSet对象检索行。

新cachedrowsetimpl() CachedRowSet CRS =；（20）setmaxrows CRS；（4）setpagesize CRS；CRS（rshandle填充，10）；

运行此代码时，CRS将充满rshandle从第十排、四排。

下一个代码片段显示填充CachedRowSet对象使用方法execute，这可能会或可能不会Connection对象作为参数。这段代码通过execute的Connection对象conhandle。

请注意，下面的代码片段和前一个代码片段有两个区别。首先，该方法setMaxRows不叫，所以没有限制的行数，CRS可以包含。（记住，CRS总有它可以存储在内存中。多少数据压倒一切的极限）第二不同的是，你不能通过方法execute出ResultSet对象的行开始检索的行数。这种方法总是从第一行开始。

新cachedrowsetimpl() CachedRowSet CRS =；（5）setpagesize CRS；CRS执行（conhandle）；

后此代码已经运行，CRS将包含五行的命令产生的 ResultSet CRS对象数据。CRS的作家会使用conhandle连接数据源和执行对CRS的命令。一个应用程序可以在它会对其他 CachedRowSet对象数据的操作方式相同CRS数据操作。

进入下一页（数据块），应用程序调用的方法nextPage。此方法创建一个新的CachedRowSet对象和填补它的下一页数据。例如，假设CachedRowSet对象的命令返回一个对象ResultSet RS 1000行数据。如果页面大小被设置为100，该方法nextPage第一次调用将创建一个包含RS的前100排CachedRowSet对象后做什么需要做这些前100行数据，应用程序可以重新调用方法nextPage与二100卢比从第一行CachedRowSet对象的数据将不再是记忆，因为它与第二CachedRowSet对象的数据替换创建另一个CachedRowSet对象。第十打电话的方法nextPage后，第十CachedRowSet对象将包含数据从RS的最后100行，这是存储在内存中。在任何给定的时间，只有一个CachedRowSet对象的数据存储在内存中。

方法nextPage返回true只要当前页不排false最后一页时，有没有更多的页面。因此，它可以被使用在一个while遍历所有的网页，就像下面的代码演示。

cachedrowsetimpl() CachedRowSet CRS =；（100）setpagesize CRS；CRS执行（conhandle）；而（CRS。nextpage()）{而（CRS。next()）{。../ /操作块（100行各）CRS，逐行行}}

之后的代码片段已经运行，应用程序必须穿过1000排，但也没有超过100行的记忆一次。

的CachedRowSet接口定义方法previousPage。同样的方法nextPage类似于ResultSet方法next，方法previousPage类似于ResultSet方法previous。类似的方法nextPage，previousPage创建一个CachedRowSet对象包含行设置为页面大小的数量。所以，例如，该方法可用于在一个previousPage while环在前面的代码片段结束后通过浏览从最后一页到第一页的页。方法previousPage也是类似nextPage在它可以用在一个while环，除了它的回报true只要有另一个页面前，false当没有更多的页面在它前面。

光标定位到每一页的最后一行后，如下面的代码片段中，previous导航的方法从最后一排在每一页的第一行。代码也可以让光标在每一页上的第一行，在while循环浏览每一页从第一行到最后一行然后使用的方法next。

下面的代码片段是从前面的代码片段的延续，这意味着第十CachedRowSet对象光标在最后一行。该代码将光标移动到最后一行后，该方法previous第一次调用将光标放在最后一排。在经历了所有在最后一页的行（CachedRowSet CRS的对象），然后代码进入while环到第九页，经过一排排向后，到第八页，经过一排排向后，等到第一页的第一行。

afterlast() CRS；而（CRS。previous()）{。../导航通过行，最后一个{而（CRS。previouspage()）{afterlast() CRS；而（CRS。previous()）{。..从最后一行到每一页的第一行}}

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	COMMIT_ON_ACCEPT_CHANGES 过时的。 因为这个字段是最终的（它是接口的一部分），它的值不能被更改。

Fields inherited from interface java.sql.ResultSet

CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE

方法摘要

Modifier and Type	Method and Description
void	acceptChanges() 传播行更新、插入和删除这个 CachedRowSet对象对底层数据源的变化。
void	acceptChanges(Connection con) 在所有行更新、插入和删除修改数据源支持这 CachedRowSet对象使用指定的 Connection对象建立到数据源的连接。
boolean	columnUpdated(int idx) 指示指定的列在这 CachedRowSet对象的当前行被更新。
boolean	columnUpdated(String columnName) 指示指定的列在这 CachedRowSet对象的当前行被更新。
void	commit() 每个 CachedRowSet对象的 SyncProvider包含 Connection对象从 ResultSet或JDBC传递给它的构造函数的特性。
CachedRowSet	createCopy() 创建一个 RowSet对象，在这 CachedRowSet对象数据的深层副本。
CachedRowSet	createCopyNoConstraints() 创建一个 CachedRowSet对象，这个对象的数据 CachedRowSet深拷贝，但它是独立的。
CachedRowSet	createCopySchema() 创建一个 CachedRowSet对象，这个对象的副本 CachedRowSet空。
RowSet	createShared() 返回一个新的 RowSet对象，这 CachedRowSet对象相同的数据支持。
void	execute(Connection conn) 这 CachedRowSet对象填充数据，使用给定的连接产生的结果集从数据将被读取。
int[]	getKeyColumns() 返回一个数组包含一个或多个列的数字表示列，形成一个键唯一标识一行在这 CachedRowSet对象。
ResultSet	getOriginal() 返回一个包含此 CachedRowSet对象的原始值 ResultSet对象。
ResultSet	getOriginalRow() 返回一个 ResultSet对象包含原始值对当前行的只有这个 CachedRowSet对象。
int	getPageSize() 返回对象的 CachedRowSet页面大小
RowSetWarning	getRowSetWarnings() 获取第一个警告，呼吁这 RowSet报道对象。
boolean	getShowDeleted() 检索 boolean指示标记为删除的行出现在当前行设置。
SyncProvider	getSyncProvider() 检索此 CachedRowSet对象的 SyncProvider实施。
String	getTableName() 返回该对象的标识符（表），用于创建此 CachedRowSet对象。
boolean	nextPage() 增量的 CachedRowSet当前页。
void	populate(ResultSet data) 这 CachedRowSet填充对象与给定的 ResultSet对象数据。
void	populate(ResultSet rs, int startRow) 这 CachedRowSet填充对象与给定的 ResultSet对象数据。
boolean	previousPage() 递减的 CachedRowSet当前页。
void	release() 发布这 CachedRowSet对象的当前内容和发送 rowSetChanged事件给所有注册的监听器。
void	restoreOriginal() 这 CachedRowSet对象恢复到其原始值，即变化前最后一组其值。
void	rollback() 每个 CachedRowSet对象的 SyncProvider包含 Connection对象从原来的 ResultSet或JDBC传递给它的性质。
void	rollback(Savepoint s) 每个 CachedRowSet对象的 SyncProvider包含 Connection对象从原来的 ResultSet或JDBC传递给它的性质。
void	rowSetPopulated(RowSetEvent event, int numRows) 通知注册的监听器，在给定的rowsetevent对象填充一些额外的行行集对象。
void	setKeyColumns(int[] keys) 这一集 CachedRowSet对象的 keyCols场与给定的列数的数组，形成独特的识别这种 CachedRowSet对象行的关键。
void	setMetaData(RowSetMetaData md) 与给定的 RowSetMetaData对象这 CachedRowSet对象的元数据集。
void	setOriginalRow() 在这 CachedRowSet对象的当前行集的行。
void	setPageSize(int size) 集 CachedRowSet对象的页面大小。
void	setShowDeleted(boolean b) 设置属性 showDeleted到给定的 boolean值，决定是否标记为删除的行出现在当前行设置。
void	setSyncProvider(String provider) 设置此 CachedRowSet对象到一个指定的 SyncProvider对象。
void	setTableName(String tabName) 设置标识符为表，这 CachedRowSet对象导出到给定的表名称。
int	size() 在这 CachedRowSet对象返回的行数。
Collection<?>	toCollection() 将 CachedRowSet对象到 Collection对象包含所有这 CachedRowSet对象的数据。
Collection<?>	toCollection(int column) 将指定的列在这 CachedRowSet对象到 Collection对象。
Collection<?>	toCollection(String column) 将指定的列在这 CachedRowSet对象到 Collection对象。
void	undoDelete() 取消对当前行的删除通知听众，行了。
void	undoInsert() 立即删除当前行从这 CachedRowSet对象如果行已插入，并通知听众，行了。
void	undoUpdate() 如果已修改行，则立即反转上次更新操作。

Methods inherited from interface javax.sql.RowSet

addRowSetListener, clearParameters, execute, getCommand, getDataSourceName, getEscapeProcessing, getMaxFieldSize, getMaxRows, getPassword, getQueryTimeout, getTransactionIsolation, getTypeMap, getUrl, getUsername, isReadOnly, removeRowSetListener, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBlob, setBlob, setBlob, setBoolean, setBoolean, setByte, setByte, setBytes, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setClob, setClob, setClob, setCommand, setConcurrency, setDataSourceName, setDate, setDate, setDate, setDate, setDouble, setDouble, setEscapeProcessing, setFloat, setFloat, setInt, setInt, setLong, setLong, setMaxFieldSize, setMaxRows, setNCharacterStream, setNCharacterStream, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNClob, setNClob, setNClob, setNString, setNString, setNull, setNull, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setObject, setPassword, setQueryTimeout, setReadOnly, setRef, setRowId, setRowId, setShort, setShort, setSQLXML, setSQLXML, setString, setString, setTime, setTime, setTime, setTime, setTimestamp, setTimestamp, setTimestamp, setTimestamp, setTransactionIsolation, setType, setTypeMap, setURL, setUrl, setUsername

Methods inherited from interface java.sql.ResultSet

absolute, afterLast, beforeFirst, cancelRowUpdates, clearWarnings, close, deleteRow, findColumn, first, getArray, getArray, getAsciiStream, getAsciiStream, getBigDecimal, getBigDecimal, getBigDecimal, getBigDecimal, getBinaryStream, getBinaryStream, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getConcurrency, getCursorName, getDate, getDate, getDate, getDate, getDouble, getDouble, getFetchDirection, getFetchSize, getFloat, getFloat, getHoldability, getInt, getInt, getLong, getLong, getMetaData, getNCharacterStream, getNCharacterStream, getNClob, getNClob, getNString, getNString, getObject, getObject, getObject, getObject, getObject, getObject, getRef, getRef, getRow, getRowId, getRowId, getShort, getShort, getSQLXML, getSQLXML, getStatement, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getType, getUnicodeStream, getUnicodeStream, getURL, getURL, getWarnings, insertRow, isAfterLast, isBeforeFirst, isClosed, isFirst, isLast, last, moveToCurrentRow, moveToInsertRow, next, previous, refreshRow, relative, rowDeleted, rowInserted, rowUpdated, setFetchDirection, setFetchSize, updateArray, updateArray, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateBigDecimal, updateBigDecimal, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBoolean, updateBoolean, updateByte, updateByte, updateBytes, updateBytes, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateClob, updateClob, updateClob, updateClob, updateClob, updateClob, updateDate, updateDate, updateDouble, updateDouble, updateFloat, updateFloat, updateInt, updateInt, updateLong, updateLong, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNString, updateNString, updateNull, updateNull, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateRef, updateRef, updateRow, updateRowId, updateRowId, updateShort, updateShort, updateSQLXML, updateSQLXML, updateString, updateString, updateTime, updateTime, updateTimestamp, updateTimestamp, wasNull

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Methods inherited from interface javax.sql.rowset.Joinable

getMatchColumnIndexes, getMatchColumnNames, setMatchColumn, setMatchColumn, setMatchColumn, setMatchColumn, unsetMatchColumn, unsetMatchColumn, unsetMatchColumn, unsetMatchColumn

Field Detail

COMMIT_ON_ACCEPT_CHANGES

@Deprecated
static final boolean COMMIT_ON_ACCEPT_CHANGES

过时的。 因为这个字段是最终的（它是接口的一部分），它的值不能被更改。

使 CachedRowSet对象的 SyncProvider提交更改时， acceptChanges()叫做。如果设置为false，变化将被提交到一个 不的 CachedRowSet接口交易方法叫做。

另请参见：

commit()， rollback()， Constant Field Values

方法详细信息

populate

void populate(ResultSet data)
       throws SQLException

这 CachedRowSet填充对象与给定的 ResultSet对象数据。

这种方法可以用来作为一种替代方法的execute当一个应用程序具有一个开放的ResultSet对象连接。使用方法populate可以比使用的execute方法不带参数的版本更有效，因为它不打开一个新的连接，并重新执行该CachedRowSet对象的命令。使用populate方法相比，使用更execute需要ResultSet对象的版本更方便。

参数

data -读到这 CachedRowSet对象包含数据的 ResultSet对象

异常

SQLException如果空 ResultSet对象提供或 CachedRowSet对象不相关的 ResultSetMetaData对象检索

另请参见：

execute(java.sql.Connection)， ResultSet， ResultSetMetaData

execute

void execute(Connection conn)
      throws SQLException

这 CachedRowSet对象填充数据，使用给定的连接产生的结果集从数据将被读取。这种方法应该关闭所有数据库连接，它创造了确保这 CachedRowSet对象断开，除非是从数据源或数据源中的数据读写数据。

这CachedRowSet目标读者将利用Conn建立到数据源的连接，它可以执行的行集的命令和读取数据从产生的ResultSet对象到这个CachedRowSet对象。这种方法也关闭了Conn后有密集的这CachedRowSet对象。

如果这个方法被调用当一个实现已经被填充，内容和元数据是（重新）设置。另外，如果这个方法在方法acceptChanges被称为提交优秀的更新，这些更新丢失。

参数

conn -有效性的标准的JDBC Connection对象

异常

SQLException -如果一个无效的 Connection对象提供或建立到数据源的连接发生错误

另请参见：

populate(java.sql.ResultSet)， Connection

acceptChanges

void acceptChanges()
            throws SyncProviderException

传播行更新、插入和删除这个 CachedRowSet对象对底层数据源的变化。

此方法调用这个对象的作家CachedRowSet做幕后工作。标准CachedRowSet实现应该使用SyncFactory独生子女获得SyncProvider实例提供了一个RowSetWriter对象（作家）。作者试图传播这CachedRowSet对象到数据源的变化。

当方法acceptChanges执行成功，除了改变写入数据源，它的值在当前行在原有的行的值。

根据不同的SyncProvider实现所采用的同步水平，笔者将比较原始值与数据源中的冲突检查。当有冲突，例如RIOptimisticProvider实施，抛出一个SyncProviderException不写任何数据源。

应用程序可以选择抓SyncProviderException对象和检索包含SyncResolver对象。对象列表的SyncResolver冲突排排和设置当前正在解决冲突，避免进一步冲突数据源上的锁。此外，对于每一个冲突，它提供了检查冲突的方法，并设置应该坚持在数据源中的值。在所有的冲突已经解决，应用程序必须调用acceptChanges方法再写解决值的数据源。如果数据源中的所有的值都已经被保存的值，该方法acceptChanges不。

一些提供程序实现可以使用锁来确保没有冲突。在这种情况下，它是保证作家能成功改变写入数据源的方法时，acceptChanges叫做。这种方法可以在方法updateRow，insertRow立即打电话，或deleteRow一直叫，但更有效的是只有一次，毕竟已经做出了改变，所以只有一个连接需要建立呼叫它。

注：本acceptChanges()方法将确定COMMIT_ON_ACCEPT_CHANGES设置为true或不。如果它被设置为真，则同步中的所有更新都将提交给数据源。否则，应用显式调用必须 commit()或rollback()合适的方法。

异常

SyncProviderException -如果基本同步提供者的作者没写回数据源的更新

另请参见：

acceptChanges(java.sql.Connection)， RowSetWriter， SyncFactory， SyncProvider， SyncProviderException， SyncResolver

acceptChanges

void acceptChanges(Connection con)
            throws SyncProviderException

在所有行更新、插入和删除修改数据源支持这 CachedRowSet对象使用指定的 Connection对象建立到数据源的连接。

acceptChanges方法的其他版本不通过连接因为它使用已经RowSet对象中定义的Connection对象，用以填充它最初的连接。

这种形式的方法acceptChanges相似，不需要参数的形式；然而，不同于其他的形式，这种形式只能在底层的数据源是一个JDBC数据源。更新Connection性质必须由SyncProvider用于RowSetWriter配置重置确保对象的内容是同步的CachedRowSet正确。

当方法acceptChanges执行成功，除了改变写入数据源，它的值在当前行在原有的行的值。

根据不同的SyncProvider实现所采用的同步水平，笔者将比较原始值与数据源中的冲突检查。当有冲突，例如RIOptimisticProvider实施，抛出一个SyncProviderException不写任何数据源。

应用程序可以选择抓SyncProviderException对象和检索包含SyncResolver对象。对象列表的SyncResolver冲突排排和设置当前正在解决冲突，避免进一步冲突数据源上的锁。此外，对于每一个冲突，它提供了检查冲突的方法，并设置应该坚持在数据源中的值。在所有的冲突已经解决，应用程序必须调用acceptChanges方法再写解决值的数据源。如果数据源中的所有的值都已经被保存的值，该方法acceptChanges不。

一些提供程序实现可以使用锁来确保没有冲突。在这种情况下，它是保证作家能成功改变写入数据源的方法时，acceptChanges叫做。这种方法可以在方法updateRow，立即打电话insertRow，或deleteRow一直叫，但更有效的是只有一次，毕竟已经做出了改变，所以只有一个连接需要建立呼叫它。

注：本acceptChanges()方法将确定COMMIT_ON_ACCEPT_CHANGES设置为true或不。如果它被设置为真，则同步中的所有更新都将提交给数据源。否则，应用显式调用必须 commit或rollback合适的方法。

参数

con -一个标准的JDBC Connection对象

异常

SyncProviderException -如果基本同步提供者的作者没写回数据源的更新

另请参见：

acceptChanges()， RowSetWriter， SyncFactory， SyncProvider， SyncProviderException， SyncResolver

restoreOriginal

void restoreOriginal()
              throws SQLException

这 CachedRowSet对象恢复到其原始值，即变化前最后一组其值。如果没有更改的行集或一组的变化，原有的价值，这 CachedRowSet对象填充的值；否则，原有的价值是它马上就其当前值前值。

调用此方法时，一个CachedRowSet实施必须确保所有的更新、插入和删除当前行集的实例是由以前的值替换。此外，光标应复位到第一排和rowSetChanged事件应该被解雇通知所有注册的监听器。

异常

SQLException -如果发生错误的来回滚动，这 CachedRowSet对象的当前值到其以前的值

另请参见：

RowSetListener.rowSetChanged(javax.sql.RowSetEvent)

release

void release()
      throws SQLException

发布这 CachedRowSet对象的当前内容和发送 rowSetChanged事件给所有注册的监听器。任何优秀的更新被丢弃，数据集不包含行调用此方法后。有与底层数据源没有相互作用，和任何数据集内容、元数据和内容的更新应该是不可恢复的。

这CachedRowSet对象应锁定到它的内容和相关的更新，完全清除，从而防止脏读取由其他组件保持参考这个RowSet对象。此外，内容不能等到所有阅读这CachedRowSet组件对象完成读取发布。这CachedRowSet对象应该是发射后rowSetChanged事件行为恢复正常。

元数据，包括JDBC性能和同步SPI性能，保持未来的使用。重要的是性能，如command属性是相关的原始数据源从最初建立这个CachedRowSet对象。

该方法把一个数据集，相对于close方法，这标志着整个数据集作为可允许垃圾收集器的行集的java虚拟机资源。

异常

如果发生错误 SQLException冲洗这 CachedRowSet对象的内容

另请参见：

RowSetListener.rowSetChanged(javax.sql.RowSetEvent)， ResultSet.close()

undoDelete

void undoDelete()
         throws SQLException

取消对当前行的删除通知听众，行了。此方法被调用后，当前行已不再标记为删除。这种方法可以随时调用的行集的一生。

此外，多行删除取消可通过调整位置的光标使用任何的光标位置等控制方法：

• CachedRowSet.absolute
• CachedRowSet.first
• CachedRowSet.last

异常

SQLException如果（1）当前行是否已被删除或（2）光标在插入行，第一行之前，或之后的最后一行

另请参见：

undoInsert()， ResultSet.cancelRowUpdates()

undoInsert

void undoInsert()
         throws SQLException

立即删除当前行从这 CachedRowSet对象如果行已插入，并通知听众，行了。这种方法可以随时调用一个行集的寿命，假设目前排在例外的局限性（见下文），取消对当前行的行插入。

此外，行插入多个取消可通过调整位置的光标使用任何的光标位置等控制方法：

• CachedRowSet.absolute
• CachedRowSet.first
• CachedRowSet.last

异常

SQLException如果（1）当前行尚未插入或（2）将光标在第一排，最后一排后，或在插入行

另请参见：

undoDelete()， ResultSet.cancelRowUpdates()

undoUpdate

void undoUpdate()
         throws SQLException

如果已修改行，则立即反转上次更新操作。这种方法可以称为反对所有列的更新直到一行中的所有更新已回滚到其状态只是上次同步前（ acceptChanges）或人口。此方法也可以被调用，同时执行插入行的更新。

undoUpdate可以随时要求一个行集的一生；但是，发生后同步，这个方法没有效果直到出现的行集数据的进一步的修改。

异常

SQLException -如果光标在第一行或最后一行在这 CachedRowSet对象后

另请参见：

undoDelete()， undoInsert()， ResultSet.cancelRowUpdates()

columnUpdated

boolean columnUpdated(int idx)
               throws SQLException

指示指定的列在这 CachedRowSet对象的当前行被更新。

参数

idx - int标识列为检查更新

结果

true如果指定列已明显 false否则更新；

异常

SQLException如果光标在插入行，第一行之前，或之后的最后一行

另请参见：

DatabaseMetaData.updatesAreDetected(int)

columnUpdated

boolean columnUpdated(String columnName)
               throws SQLException

指示指定的列在这 CachedRowSet对象的当前行被更新。

参数

columnName - String对象给予的列名称进行检查更新

结果

true如果柱已经明显 false否则更新；

异常

SQLException如果光标在插入行，第一行之前，或之后的最后一行

另请参见：

DatabaseMetaData.updatesAreDetected(int)

toCollection

Collection<?> toCollection()
                    throws SQLException

将 CachedRowSet对象到 Collection对象包含所有这 CachedRowSet对象的数据。实现有一些纬度如何能够代表这个 Collection对象因为 Collection框架的抽象本质。每一行必须是一个通用的 Collection实现或专业 Collection实施充分的代表，如 TreeMap对象或 Vector对象。一个SQL NULL列值必须是java编程语言的 null。

为CachedRowSet接口标准的参考实现使用一个TreeMap对象的值的行集，每行包含在Vector对象。预计大多数实现将做相同的。

这张Map将在提升的关键点收集保证TreeMap型，根据关键的类的自然顺序排序。每一个关键的参考Vector对象对应一行一RowSet对象。因此，每个Vector对象的大小必须相等RowSet对象中的列数。由TreeMap收集使用的关键是由实现确定，可选择的杠杆设置键，可在内部RowSet表格结构的关键已经设置在RowSet对象本身或潜在的SQL数据的美德。

结果

一个 Collection对象包含的值在每一行在这 CachedRowSet对象

异常

SQLException -如果出现错误产生的集合

另请参见：

toCollection(int)， toCollection(String)

toCollection

Collection<?> toCollection(int column)
                    throws SQLException

将指定的列在这 CachedRowSet对象到 Collection对象。实现有一些纬度如何能够代表这个 Collection对象因为 Collection框架的抽象本质。每一列的值应该是一个通用的 Collection实现或专业 Collection实施充分的代表，如 Vector对象。一个SQL NULL列值必须是java编程语言的 null。

标准的参考实现使用一个Vector对象包含该列的值，并将大部分实现也会做同样的事。如果一个Vector对象时，它的大小必须正好等于该CachedRowSet对象的行数。

参数

column - int指示其值是在一个 Collection对象表示的列

结果

一个 Collection对象包含存储在指定的列的值 CachedRowSet对象

异常

SQLException -如果出现错误产生的集合或无效的列ID设置

另请参见：

toCollection()， toCollection(String)

toCollection

Collection<?> toCollection(String column)
                    throws SQLException

将指定的列在这 CachedRowSet对象到 Collection对象。实现有一些纬度如何能够代表这个 Collection对象因为 Collection框架的抽象本质。每一列的值应该是一个通用的 Collection实现或专业 Collection实施充分的代表，如 Vector对象。一个SQL NULL列值必须是java编程语言的 null。

标准的参考实现使用一个Vector对象包含该列的值，并将大部分实现也会做同样的事。如果一个Vector对象时，它的大小必须正好等于该CachedRowSet对象的行数。

参数

column - String对象给其值的列的名称是一个集合表示

结果

一个 Collection对象包含存储在指定的列的值 CachedRowSet对象

异常

SQLException -如果出现错误产生的集合或无效的列ID设置

另请参见：

toCollection()， toCollection(int)

getSyncProvider

SyncProvider getSyncProvider()
                      throws SQLException

检索此 CachedRowSet对象的 SyncProvider实施。在内部，这种方法是通过一个数据集用于触发读取或写入的数据集和数据源之间的行为。例如，一个数据集可能需要掌握的行集的读者（ RowSetReader对象）从 SyncProvider允许行集是稠密的。

rowsetreader rowsetreader = null；syncprovider提供商=syncfactory。getInstance（“javax. SQL。行集。供应商。RIOptimisticProvider）；如果（供应商是rioptimisticprovider）{rowsetreader =供应商。getrowsetreader()；}

假设rowsetreader是私人领域，可以在该行实现，当应用程序调用的 execute方法，它会要求读者的 readData方法来填充 RowSet对象。

rowsetreader。readdata（（rowsetinternal）本）；

此外，应用程序可以使用SyncProvider此方法返回的对象调用方法返回的SyncProvider对象信息，包括供应商、版本、供应商识别，同步等级信息，并锁定目前已设置。

结果

的 SyncProvider对象时设置了行集被实例化，或者如果没有设置，默认提供程序

异常

SQLException -如果发生错误而返回 SyncProvider对象

另请参见：

setSyncProvider(java.lang.String)

setSyncProvider

void setSyncProvider(String provider)
              throws SQLException

设置此 CachedRowSet对象到一个指定的 SyncProvider对象。这种方法允许 SyncProvider对象被重置。

一个CachedRowSet实施应该实例化一个可用的SyncProvider机制，但在有些情况下，重置SyncProvider对象是可取或必要的。例如，一个应用程序可能要使用默认的SyncProvider对象一段时间后再选择使用一个供应商，最近已成为可用，更适合它的需要。

重置SyncProvider对象使RowSet对象从SyncFactory请求一个新的SyncProvider实现。这已重置所有以前的联系和关系与原始数据源的影响，有可能彻底改变一个断开的行集的同步行为。

参数

provider - String对象的完全限定类名一 SyncProvider实施

异常

SQLException -如果在尝试重置 SyncProvider执行发生错误

另请参见：

getSyncProvider()

size

int size()

在这 CachedRowSet对象返回的行数。

结果

在该行的行数

setMetaData

void setMetaData(RowSetMetaData md)
          throws SQLException

与给定的 RowSetMetaData对象这 CachedRowSet对象的元数据集。当一个 RowSetReader对象读取数据集的内容，它创建了一个 RowSetMetaData对象并初始化它的 RowSetMetaData实现使用方法。参考实现使用 RowSetMetaDataImpl类。当读者完成了阅读的行集的内容，这种方法称为内部通过 RowSetMetaData目的行集。

参数

md -包含在这 CachedRowSet对象列的元数据 RowSetMetaData对象

异常

SQLException如果无效的元数据提供给数据集

getOriginal

ResultSet getOriginal()
               throws SQLException

返回一个 ResultSet对象包含此 CachedRowSet对象的原始值。

为ResultSet对象光标应定位在第一行的前面。此外，返回的ResultSet对象应具备以下性能：

• resultset.type_scroll_insensitive
• resultset.concur_updatable

一RowSet对象原有的价值是它与底层数据源上同步前值。如果没有同步，原有的价值，将价值的RowSet对象填充。这种方法被称为内部，当应用程序调用对象的方法和SyncProvider acceptChanges进行冲突检查。如果是这样的话，作者将原始的值与当前在数据源中的值进行比较，以检查冲突。

结果

一个 ResultSet对象包含此 CachedRowSet对象的原始值

异常

SQLException -如果出现错误产生的 ResultSet对象

getOriginalRow

ResultSet getOriginalRow()
                  throws SQLException

返回一个 ResultSet对象包含原始值对当前行的只有这个 CachedRowSet对象。

为ResultSet对象光标应定位在第一行的前面。此外，返回的ResultSet对象应具备以下性能：

• resultset.type_scroll_insensitive
• resultset.concur_updatable

结果

该行的原始结果集

异常

SQLException -如果没有当前行

另请参见：

setOriginalRow()

setOriginalRow

void setOriginalRow()
             throws SQLException

在这 CachedRowSet对象的当前行集的行。

此方法被调用后，在当前行中的任何修改后的值都与数据源同步。当前行必须被标记为不再插入、删除或更新的。

一个叫setOriginalRow是不可逆转的。

异常

SQLException -如果没有当前行或遇到错误复位的原行的内容

另请参见：

getOriginalRow()

getTableName

String getTableName()
             throws SQLException

返回该对象的标识符（表），用于创建此 CachedRowSet对象。此名称可以设置在多个场合，该规范不规定可能发生多少次，或者是否标准的实现应该保持以前的表名称的跟踪。

结果

一个 String物体的表，是此 CachedRowSet对象或 null数据源如果没有名字已经设置为表的名称

异常

SQLException -如果遇到错误返回的表名称

另请参见：

ResultSetMetaData.getTableName(int)

setTableName

void setTableName(String tabName)
           throws SQLException

设置标识符为表，这 CachedRowSet对象导出到给定的表名称。作者用这个名字来确定哪些表时要使用的值比较，与 CachedRowSet对象值的数据源同步的尝试中。表的标识也表明修改的值从这个 CachedRowSet对象应写。

这CachedRowSet对象的实现可能来自公司内部的RowSetMetaDataImpl对象获得的名字。

参数

tabName - String对象识别从导出的这 CachedRowSet对象表；不能 null但可能是一个空字符串

异常

SQLException -如果遇到错误或是 null但是命名表

另请参见：

RowSetMetaData.setTableName(int, java.lang.String)， RowSetWriter， SyncProvider

getKeyColumns

int[] getKeyColumns()
             throws SQLException

返回一个数组包含一个或多个列的数字表示列，形成一个键唯一标识一行在这 CachedRowSet对象。

结果

一个数组包含的列数或数字显示哪些列为本 CachedRowSet对象行的主键。如果没有列是主键的代表，则该数组应该是空的。

异常

SQLException -如果这 CachedRowSet对象是空的

另请参见：

setKeyColumns(int[])， Joinable.getMatchColumnIndexes()， Joinable.getMatchColumnNames()

setKeyColumns

void setKeyColumns(int[] keys)
            throws SQLException

这一集 CachedRowSet对象的 keyCols场与给定的列数的数组，形成独特的识别这种 CachedRowSet对象行的关键。

如果一个CachedRowSet对象成为一个JoinRowSet对象的一部分，钥匙由该方法定义和由此产生的约束，如果指定为键列也成为比赛的柱子保持。

参数

keys - int指示列，形成这个 CachedRowSet对象主键数组；数组中的每个元素必须大于 0小于或等于该行中的列数

异常

SQLException -如果任何的数据在给定的数组不符合该行集

另请参见：

getKeyColumns()， Joinable.setMatchColumn(String)， Joinable.setMatchColumn(int)

createShared

RowSet createShared()
             throws SQLException

返回一个新的 RowSet对象，这 CachedRowSet对象相同的数据支持。实际上，无论是 CachedRowSet对象有相同数据的指针。因此，由一个副本所做的任何更改都是可见的，以原始和任何其他重复，就像原来的变化是可见的，它所有的重复。如果重复调用一个方法改变底层数据的方法，它要求通知所有注册的监听器一样当它被称为原 CachedRowSet对象。

此外，任何RowSet对象通过此方法创建将为这CachedRowSet对象具有相同的性质。例如，如果这CachedRowSet对象是只读的，它的所有副本也将是只读的。如果改为可更新的副本也成为可更新。

注意：如果多个线程访问RowSet对象从createShared()方法创建的，以下行为是指定保存共享数据完整性：读取和写入所有的共享RowSet对象应连续之间的每个对象和单一的底层表结构。

结果

一个新的共享 RowSet对象具有相同的性质，这 CachedRowSet对象，在同一个数据指针

异常

SQLException -如果发生错误或克隆不在底层平台的支持

另请参见：

RowSetEvent， RowSetListener

createCopy

CachedRowSet createCopy()
                 throws SQLException

创建一个 RowSet对象，在这 CachedRowSet对象数据的深层副本。相反，从 createShared调用所生成的 RowSet对象，对原有的 RowSet对象副本更新不得对原 RowSet对象可见。同时，与原 RowSet注册事件监听器必须没有范围在新 RowSet副本。此外，任何建立的约束限制，必须保持。

结果

一个新的 RowSet对象，这 CachedRowSet对象的深层副本，是完全独立的，这 CachedRowSet对象

异常

SQLException如果产生的这 CachedRowSet对象复制发生错误

另请参见：

createShared()， createCopySchema()， createCopyNoConstraints()， RowSetEvent， RowSetListener

createCopySchema

CachedRowSet createCopySchema()
                       throws SQLException

创建一个 CachedRowSet对象，这个对象的副本 CachedRowSet空。复印件必须不包含任何内容只代表原 CachedRowSet对象表结构。此外，主键或外键约束集的始发 CachedRowSet对象必须在新的空 CachedRowSet对象同样执行。在对比的 RowSet对象从一个 createShared方法调用生成，对副本的 createCopySchema方法这 CachedRowSet对象更新不能看到它。

应用程序可以从CachedRowSet对象WebRowSet此方法返回的对象为出口RowSet架构定义的XML用于将来使用。

结果

这 CachedRowSet空复制对象

异常

SQLException -如果这 CachedRowSet克隆对象的结构发生了一个错误

另请参见：

createShared()， createCopySchema()， createCopyNoConstraints()， RowSetEvent， RowSetListener

createCopyNoConstraints

CachedRowSet createCopyNoConstraints()
                              throws SQLException

创建一个 CachedRowSet对象，这个对象的数据 CachedRowSet深拷贝，但它是独立的。相反，从 createShared方法调用所产生的 RowSet对象，做一份本 CachedRowSet对象更新不能看到它。另外，有这 CachedRowSet对象注册事件侦听器必须在新的 RowSet对象范围。此外，任何的约束限制了这 CachedRowSet对象必须 不保持副本。

结果

一个新的 CachedRowSet对象，这 CachedRowSet对象的深层副本，是完全独立的，这 CachedRowSet对象

异常

SQLException如果产生的这 CachedRowSet对象复制发生错误

另请参见：

createCopy()， createShared()， createCopySchema()， RowSetEvent， RowSetListener

getRowSetWarnings

RowSetWarning getRowSetWarnings()
                         throws SQLException

获取第一个警告，呼吁这 RowSet报道对象。在这 RowSet对象随后的警告将被锁在 RowSetWarning对象，该方法返回。每一个新的行读取时，警告链会自动清除。这种方法可能不被称为行集对象已关闭；这样做将导致 SQLException被。

结果

rowsetwarning第一 RowSetWarning报道对象或空如果没有

异常

SQLException -如果调用此方法在一个封闭的行集

另请参见：

RowSetWarning

getShowDeleted

boolean getShowDeleted()
                throws SQLException

检索 boolean指示标记为删除的行出现在当前行设置。如果 true返回，删除行与当前可见行。如果 false返回当前行，行集是不可见的。默认值是 false

标准数据集的实现可能选择限制这种行为出于安全的考虑或更适合特定的部署方案。这是左作为实现定义的，不代表标准的行为。

注：允许删除的行保持可见的复杂的一些标准的JDBC RowSet实现方法的行为。然而，大多数的行集，用户可以简单地忽略这额外的细节，因为只有非常专业的应用程序可能会想利用这一特点。

。

结果

true如果删除的行是可见的； false否则

异常

SQLException -如果一个行集的实现是无法确定是否标记为删除的行是可见的

另请参见：

setShowDeleted(boolean)

setShowDeleted

void setShowDeleted(boolean b)
             throws SQLException

设置属性 showDeleted到给定的 boolean值，决定是否标记为删除的行出现在当前行设置。如果该值设置为 true，删除行立即可见，当前行集。如果该值设置为 false，被删除的行设置为不可见行的当前设置。

标准数据集的实现可能选择限制这种行为出于安全的考虑或更适合特定的部署方案。这是左作为实现定义的，不代表标准的行为。

参数

b - true如果删除的行应该显示； false否则

异常

SQLException -如果一个行集的实现是无法重置已删除的行是否应该是可见的

另请参见：

getShowDeleted()

commit

void commit()
     throws SQLException

每个 CachedRowSet对象的 SyncProvider包含 Connection对象从 ResultSet或JDBC传递给它的构造函数的特性。该方法将 Connection提交方法允许灵活的自动提交或非自动提交事务控制支持。

让所有的变化都是由acceptChanges()方法进行自上次提交/回滚永久。此方法应仅在自动提交模式已禁用时使用。

异常

SQLException -如果一个数据库访问错误发生或在这 CachedRowSet对象连接在自动提交模式

另请参见：

Connection.setAutoCommit(boolean)

rollback

void rollback()
       throws SQLException

每个 CachedRowSet对象的 SyncProvider包含 Connection对象从原来的 ResultSet或JDBC传递给它的性质。

撤消所有更改在当前事务。此方法应仅在自动提交模式已禁用时使用。

异常

SQLException -如果一个数据库访问错误发生或在这 CachedRowSet对象连接在自动提交模式。

rollback

void rollback(Savepoint s)
       throws SQLException

每个 CachedRowSet对象的 SyncProvider包含 Connection对象从原来的 ResultSet或JDBC传递给它的性质。

在当前事务撤消所有更改回过去Savepoint事务标记。此方法应仅在自动提交模式已禁用时使用。

参数

s - Savepoint事务标记

异常

SQLException -如果一个数据库访问错误发生或在这 CachedRowSet对象连接在自动提交模式。

rowSetPopulated

void rowSetPopulated(RowSetEvent event,
                     int numRows)
              throws SQLException

通知注册的监听器，在给定的rowsetevent对象填充一些额外的行行集对象。的 numRows参数确保这个事件只会被解雇的每一 numRow。

事件源的方法可event.getsource检索。

参数

event - RowSetEvent包含 RowSet对象，事件的源头

numRows当填充，行间隔，火应该 CachedRowSet人口数；默认值是零；不能小于 fetchSize或零

异常

SQLException - numRows < 0 or numRows < getFetchSize()

populate

void populate(ResultSet rs,
              int startRow)
       throws SQLException

这 CachedRowSet填充对象与给定的 ResultSet对象数据。而对 populate(ResultSet)方法有关，一个额外的参数提供的起始位置在 ResultSet从哪里来填充CachedRowSet实例。

这种方法可以用来作为一种替代方法的execute当一个应用程序具有一个开放的ResultSet对象连接。使用方法populate可以比使用的execute方法不带参数的版本更有效，因为它不打开一个新的连接，并重新执行该CachedRowSet对象的命令。使用populate方法相比，使用更execute需要ResultSet对象的版本更方便。

参数

startRow在 ResultSet位置从哪里开始填充记录该 CachedRowSet

rs -读到这 CachedRowSet对象包含数据的 ResultSet对象

异常

SQLException如果空 ResultSet对象提供或 CachedRowSet对象不相关的 ResultSetMetaData对象检索

另请参见：

execute(java.sql.Connection)， populate(ResultSet)， ResultSet， ResultSetMetaData

setPageSize

void setPageSize(int size)
          throws SQLException

集 CachedRowSet对象的页面大小。一个 CachedRowSet可以被配置来填充自己的页面大小尺寸的批行。当 populate()或 execute()称， CachedRowSet获取额外的页面根据用来填充数据集的SQL查询。

参数

size的 CachedRowSet页面大小

异常

SQLException -如果出现错误设置 CachedRowSet页面大小或者页面大小小于0。

getPageSize

int getPageSize()

返回对象的 CachedRowSet页面大小

结果

一个 int页面大小

nextPage

boolean nextPage()
          throws SQLException

增量的 CachedRowSet当前页。这使得 CachedRowSet实现取下一页大小的行和填充数据集，如果剩余行保持在用于原始的SQL查询范围填充数据集。

结果

如果有更多的页面存在，如果这是最后一页，则是错误的

异常

SQLException -如果出现错误，取下一个页面，或者如果这个方法被调用之前过早填充或执行。

previousPage

boolean previousPage()
              throws SQLException

递减的 CachedRowSet当前页。这使得 CachedRowSet实现取前一页大小的行和填充数据集。行量返回前一页必须始终保持在用来填充数据集的SQL查询范围。

结果

如果上一页已成功检索，则为真；如果这是第一页。

异常

SQLException -如果出现错误，取前一页，或者如果这个方法被调用之前过早填充或执行。