JDBC API ResultSet接口(记录集接口)
在 JDBC API 2.0 中,ResultSet 接口有了很大的变化,增加了很多行操作、行定位的新方法,功能也强大了许多,下面我们就详细地对其进行介绍。
上述新定义的常数其游标移动的方向等性质如下:
注意,在 public boolean relative(int rows) 方法中,参数 rows 表示目标行相对于当前行的行号,例如当前行是第 3 行,现在需要移动到第 5 行,则既可以使用 absolute() 方法,也可以使用 relative() 方法,代码如下:
其中,rs 代表 ResultSet 接口的实例对象。
又如,当前行是第 5 行,需要移动到第 3 行的代码如下:
其中,rs 代表 ResultSet 接口的实例对象。
注意,传递给 relative() 方法的参数,如果是正数,那么数据库游标向前移动;如果是负数,那么数据库游标向后移动。
【例1】使用 ResultSet 接口的方法在记录集中定位到特定的行。dbScroll.jsp 的代码如下:
dbScroll.jsp 的运行环境是 BEA WebLogic Server,数据库服务器是 Microsoft SQL Server 2010,主机名为 rainbow,数据库服务器侦听端口为 1433,数据库的名称是 fancy,创建 fancy 数据库的 SQL 文件是 db.sql。读者不能使用 JDBC-ODBC 桥驱动程序,否则会出错。
ResultSet 接口中还定义了多个 updateXXX() 方法,都和上面的两个方法类似,由于篇幅的原因,这里不再详细描述。
在数据库的当前记录集插入新行的操作流程如下:
【例2】实现在数据库中插入新的行(亦即新的记录)。insertRow.jsp 的代码如下:
insertRow.jsp 向 fancy 数据库的 tbuser 表插入了两行,亦即两个记录,然后执行数据库查询,检查 INSERT 操作对数据库的影响,insertRow.jsp 程序应用了上面讲述的方法,比较简单,这里就不重复介绍程序中所用到的各个方法了。
更新数据库中某个记录的值(某行的值)的方法如下:
删除记录集中某行(亦即删除某个记录)的方法是定位到需要修改的行(使用 absolute()、relative()等方法定位),使用 deleteRow() 方法删除。
ResultSet 接口扩充了 getXXX() 方法,添加获取数据的 getXXX() 方法有:getARRAY()、getBlob()、getBigDecimal()、getClob()、getRef(),这些方法既可以接收列索引为参数,也可以接收列名(字段名)为参数,这些方法分别返回对应的 Java 对象实例,如 ClobARRAY(JDBC ARRAY)、Blob、BigDecimal、Ref 等,使用起来十分方便。这些方法的用法在下面还会涉及,这里就不再赘述了。
使用 getRow() 方法,返回记录集最后一行的行索引。该索引就等于记录集所包含记录的个数。
1. 新定义了若干个常数
在 JDBC API 2.0 中,新定义了许多常数用来指定 ResultSet 的类型,如下所示:
public static final int FETCH_FORWARD;
public static final int FETCH_REVERSE;
public static final int FETCH_UNKNOWN;
public static final int TYPE_FORWARD_ONLY;
public static final int TYPE_SCROLL_INSENSITIVE;
public static final int TYPE_SCROLL_SENSITIVE;
public static final int CONCUR_READ_ONLY;
public static final int CONCUR_UPDATABLE;
上述新定义的常数其游标移动的方向等性质如下:
- fetch_forward:该常数的作用是指定处理记录集中行的顺序是由前到后,即从第一行开始处理,一直到最后一行。
- fetch_reverse:该常数的作用是指定处理记录集中行的顺序是由后到前,即从最后一行开始处理一直到第一行。
- fetch_unknown:该常数的作用是不指定处理记录集中行的顺序,由 JDBC 驱动程序和数据库系统决定。
- type_forward_only:该常数的作用是指定数据库游标的移动方向是向前,不允许向后移动,即只能使用 ResultSet 接口的 next() 方法,而不能使用 previous() 方法,否则会产生错误。
- type_scroll_insensitive:该常数的作用是指定数据库游标可以在记录集中前后移动,并且当前数据库用户获取的记录集对其他用户的操作不敏感。就是说当前用户浏览记录集中的数据的同时,其他用户更新了数据库中的数据,但是当前用户所获取的记录集中的数据不会受到任何影响。
- type_scroll_sensitive:该常数的作用是指定数据库游标可以在记录集中前后移动,并且当前数据库用户获取的记录集对其他用户的操作敏感。就是说,当前用户正在浏览记录集,若其他用户的操作使数据库中的数据发生了变化,则当前用户所获取的记录集中的数据也会同步发生变化。这样有可能会导致非常严重的错误,建议慎重使用该常数。
- concur_read_only:该常数的作用是指定当前记录集的协作方式(concurrency mode)为只读,一旦使用了这个常数,则不可以更新记录集中的数据。
- concur_updatable:该常数的作用是指定当前记录集的协作方式(concurrency mode)为可以更新,一旦使用了这个常数,就可以使用 updateXXX() 等方法更新记录集中的数据。
2. ResultSet接口提供了一整套的定位方法
这些定位方法可以在记录集中定位到任意一行,具体有 public boolean absolute(int row)、public boolean relative(int rows) 等方法,如下表所示:方法 | 作用 |
---|---|
public boolean absolute(int row) |
该方法的作用是将记录集中的某一行设定为当前行,亦即将数据库游标移动到指定的行参数 row 指定的目标行的行号,这是绝对的行号,由记录集的第一行开始计算。 |
public boolean relative(int rows) |
该方法的作用也是将记录集中的某一行设定为当前行,但是它的参数 rows 表示目标行相对 于当前行的行号。 |
public boolean first() | 该方法的作用是将当前行定位到数据库记录集的第一行。 |
public boolean last() | 该方法的作用刚好和 first() 方法相反,是将当前行定位到数据库记录集的最后一行。 |
public boolean isFirst() | 该方法的作用是检查当前行是否为记录集的第一行。如果是,返回 true,否则返回 false。 |
public boolean isLast() | 该方法的作用是检查当前行是否为记录集的最后一行。如果是,返回 true,否则返回 false。 |
public void afterLast() |
该方法的作用是将数据库游标移到记录集的最后,位于记录集最后一行的后面。如果该记录 集不包含任何行,该方法不产生作用。 |
public void beforeFirst() |
该方法的作用是将数据库游标移到记录集的最前面,位于记录集第一行的前面。如果记录集 不包含任何行,该方法不产生作用。 |
public boolean isAfterLast() | 该方法检查数据库游标是否处于记录集的最后面。如果是,返回 true,否则返回 false。 |
public boolean isBeforeFirst() | 该方法检查数据库游标是否处于记录集的最前面。如果是,返回 true,否则返回 false。 |
public boolean next() |
该方法的作用是将数据库游标向前移动一位,使得下一行成为当前行。当刚刚打开记录集对象 时,数据库游标的位置在记录集的最前面。第一次使用 next() 方法,将会使数据库游标定位到 记录集的第一行;第二次使用 next() 方法,将会使数据库游标定位到记录集的第二行;以此类 推。 |
public boolean previous() | 该方法的作用是将数据库游标向后移动一位,使得上一行成为当前行。 |
注意,在 public boolean relative(int rows) 方法中,参数 rows 表示目标行相对于当前行的行号,例如当前行是第 3 行,现在需要移动到第 5 行,则既可以使用 absolute() 方法,也可以使用 relative() 方法,代码如下:
rs.absolute(5);或者
rs.relative(2);
其中,rs 代表 ResultSet 接口的实例对象。
又如,当前行是第 5 行,需要移动到第 3 行的代码如下:
rs.absolute(3);或者
rs.relative(-2);
其中,rs 代表 ResultSet 接口的实例对象。
注意,传递给 relative() 方法的参数,如果是正数,那么数据库游标向前移动;如果是负数,那么数据库游标向后移动。
【例1】使用 ResultSet 接口的方法在记录集中定位到特定的行。dbScroll.jsp 的代码如下:
<%--File Name:Application.java--%> <%@page import="java.sql.*" %> <% String url="jdbc:weblogic:mssqlserver4:rainbow:1433"; Connection con; Statement stmt; try { Class.forName("weblogic.jdbc.mssqlserver4.Driver "); } catch(java.lang.ClassNotFoundException e) { out.print("ClassNotFoundException: "); out.println(e.getMessage()); } try { con=DriverManager .getConnection (url "sa" ""); stmt=con.createStatement (ResultSet.TYPE_SCROLL_SENSITIVE ResultSet.CONCUR_READ_ONLY); ResultSet srs=stmt.executeQuery("USE fancy SELECT * FROM goods"); srs.absolute(4); int rowNum=srs.getRow(); //rowNum should be 4 out.println("rowNum should be 4"+rowNum); srs.relative(-3); rowNum=srs.getRow(); //rowNum should be 1 out.println("rowNum should be 1"+rowNum); srs.relative(2); rowNum=srs.getRow(); //rowNum should be 3 out.println("rowNum should be 3"+rowNum); srs.absolute(1); out.println("after last?"+srs.isAfterLast()); if(!srs.isAfterLast()) { String name=srs.getString("goodsname"); float price=srs.getFloat("price"); out.println(name+" "+price); } srs.afterLast(); while (srs.previous()) { String name=srs.getString("goodsname"); float price=srs.getFloat("price"); out.println(name+" "+price); } srs.close(); stmt.close(); con.close(); } catch(BatchUpdateException b) { out.println("-----BatchUpdateException-----"); out.println("SQL State:"+b.getSQL State()); out.println("Message:"+b.getMessage()); out.println("Vendor:"+b.getErrorCode()); out.print("Update counts: "); int [] updateCounts=b.getUpdateCounts(); for(int i=0;i<updateCounts.length;i++) { out.print(updateCounts[i]+" "); } out.println(""); } catch(SQL Exception ex) { out.println("-----SQL Exception-----"); out.println("SQL State:"+ex.getSQL State()); out.println("Message:"+ex.getMessage()); out.println("Vendor:"+ex.getErrorCode()); } %>
dbScroll.jsp 的运行环境是 BEA WebLogic Server,数据库服务器是 Microsoft SQL Server 2010,主机名为 rainbow,数据库服务器侦听端口为 1433,数据库的名称是 fancy,创建 fancy 数据库的 SQL 文件是 db.sql。读者不能使用 JDBC-ODBC 桥驱动程序,否则会出错。
3. ResultSet接口添加了对行操作的支持
使用 JDBC API 不仅可以将数据库游标定位到记录集中的特定行,而且还可以使用 ResultSet 接口新定义的一套方法更新当前行的数据。ResultSet 接口对数据库的基本操作方法如下表所示。方法 | 作用 |
---|---|
public boolean rowDeleted() |
如果当前记录集的某行被删除了,那么记录集中将会留出一个空位, 调用 rowDeleted() 方法。如果探测到空位的存在那么就返回 true, 如果没有探测到空位的存在就返回 false。 |
public boolean rowInserted() |
如果当前记录集中插入了一个新行,该方法将返回 true,否则返回 false。 |
public boolean rowUpdated() |
如果当前记录集的当前行的数据被更新,该方法返回 true,否则返 回 false。 |
public void insertRow() | 该方法将执行在当前记录集插入一个新行的操作。 |
public void updateRow() | 该方法将更新当前记录集当前行的数据。 |
public void deleteRow() | 该方法将删除当前记录集的当前行。 |
public void updateString(int columnlndex,String x) |
该方法更新当前记录集当前行某列的值,该列的数据类型是 String (指 Java 数据类型是 String,与之对应的 JDBC 数据类型是 VARCHAR 或 NVARCHAR 等)。该方法的参数 columnIndex 指 定所要更新的列的列索引,第一列的列索引是 1,以此类推;第二 个参数 x 代表新的值。这个方法并不执行数据库操作,需要执行 insertRow() 方法或者 updateRow() 方法以后,记录集和数据库中 的数据才能够真正更新。 |
public void updateString(String columnName,String x) |
该方法和上面介绍的同名方法差不多,不过该方法的第一个参数是 cohmnName,代表需要更新的列的列名而不是 columnIndex。 |
ResultSet 接口中还定义了多个 updateXXX() 方法,都和上面的两个方法类似,由于篇幅的原因,这里不再详细描述。
在数据库的当前记录集插入新行的操作流程如下:
- 调用 moveToInsertRow() 方法。
- 调用 updateXXX() 方法指定插入行各列的值。
- 调用 insertRow() 方法往数据库中插入新的行。
【例2】实现在数据库中插入新的行(亦即新的记录)。insertRow.jsp 的代码如下:
<%@page import="java.sql.*" %> <% String url="jdbc:weblogic:mssqlserver4:rainbow:1433"; Connection con; Statement stmt; try { Class.forName("weblogic.jdbc.mssqlserver4.Driver "); } catch(java.lang.ClassNotFoundException e) { out.println("ClassNotFoundException: "); out.println(e.getMessage()); } try { con=DriverManager.getConnection (url "sa" ""); stmt=con.createStatement (ResultSet.TYPE_SCROLL_SENSITIVE ResultSet.CONCUR_UPDATABLE); ResultSet uprs=stmt.executeQuery("USE fancy SELECT * FROM tbuser"); uprs.moveToInsertRow(); uprs.updateString("username" "peking"); uprs.updateString(2 "peking"); uprs.insertRow(); uprs.updateString(1 "lijishan"); uprs.updateString("password" "lijishan"); uprs.insertRow(); uprs.beforeFirst(); out.println("Table tbuser after insertion:"); while (uprs.next()) { String name=uprs.getString("username"); String pass=uprs.getString("password"); out.println("username:"+name+"<br>"); out.println("password:"+pass+"<br>"); } uprs.close(); stmt.close(); con.close(); } catch(SQL Exception ex) { out.println("SQL Exception:"+ex.getMessage()); } %>
insertRow.jsp 向 fancy 数据库的 tbuser 表插入了两行,亦即两个记录,然后执行数据库查询,检查 INSERT 操作对数据库的影响,insertRow.jsp 程序应用了上面讲述的方法,比较简单,这里就不重复介绍程序中所用到的各个方法了。
更新数据库中某个记录的值(某行的值)的方法如下:
- 定位到需要修改的行(使用 absolute()、relative() 等方法定位)。
- 使用相应的 updateXXX() 方法设定某行某列的新值,XXX 所代表的 Java 数据类型必须可以映射为某列的 JDBC 数据类型,如果希望 rollback 该项操作,需要再调用 updateRow() 方法以前使用的 cancelRowUpdates() 方法,这个方法可以将某行某列的值复原。
- 使用 updateRow() 方法,完成 UPDATE 的操作。
删除记录集中某行(亦即删除某个记录)的方法是定位到需要修改的行(使用 absolute()、relative()等方法定位),使用 deleteRow() 方法删除。
4. 新的ResultSet接口添加了对SQL 3数据类型的支持
SQL 3 技术规范中添加了若干个新的数据类型,如 REF、ARRAY 等。ResultSet 接口扩充了 getXXX() 方法,添加获取数据的 getXXX() 方法有:getARRAY()、getBlob()、getBigDecimal()、getClob()、getRef(),这些方法既可以接收列索引为参数,也可以接收列名(字段名)为参数,这些方法分别返回对应的 Java 对象实例,如 ClobARRAY(JDBC ARRAY)、Blob、BigDecimal、Ref 等,使用起来十分方便。这些方法的用法在下面还会涉及,这里就不再赘述了。
5. 获取记录集行数的方法
使用 last() 方法,将数据库游标定位到记录集的最后一行。使用 getRow() 方法,返回记录集最后一行的行索引。该索引就等于记录集所包含记录的个数。
所有教程
- socket
- Python基础教程
- C#教程
- MySQL函数
- MySQL
- C语言入门
- C语言专题
- C语言编译器
- C语言编程实例
- GCC编译器
- 数据结构
- C语言项目案例
- C++教程
- OpenCV
- Qt教程
- Unity 3D教程
- UE4
- STL
- Redis
- Android教程
- JavaScript
- PHP
- Mybatis
- Spring Cloud
- Maven
- vi命令
- Spring Boot
- Spring MVC
- Hibernate
- Linux
- Linux命令
- Shell脚本
- Java教程
- 设计模式
- Spring
- Servlet
- Struts2
- Java Swing
- JSP教程
- CSS教程
- TensorFlow
- 区块链
- Go语言教程
- Docker
- 编程笔记
- 资源下载
- 关于我们
- 汇编语言
- 大数据
- 云计算
- VIP视频