ResultSet详解

发布时间 2023-04-03 09:56:37作者: 围观的小妖g

ResultSet类型

ResultSet对象的类型主要体现在两个方面:

(1)游标可操作的方式。

(2)ResultSet对象的修改对数据库的影响。

后者称为ResultSet对象的敏感性。ResultSet有3种不同的类型,分别说明如下。

(1)TYPE_FORWARD_ONLY

​ 这种类型的ResultSet不可滚动,游标只能向前移动,从第一行到最后一行,不允许向后移动,即只能使用ResultSet接口的next()方 法,而不能使用previous()方法,否则会产生错误。

(2)TYPE_SCROLL_INSENSITIVE

​ 这种类型的ResultSet是可滚动的,它的游标可以相对于当前位置向前或向后移动,也可以移动到绝对位置。当ResultSet没有关闭 时,ResultSet的修改对数据库不敏感,也就是说对ResultSet对象的修改不会影响对应的数据库中的记录。

(3)TYPE_SCROLL_SENSITIVE

​ 这种类型的ResultSet是可滚动的,它的游标可以相对于当前位置向前或向后移动,也可以移动到绝对位置。当ResultSet没有关闭时,对ResultSet对象的修改会直接影响数据库中的记录。

当ResultSet没有关闭时,对ResultSet对象的修改会直接影响数据库中的记录。

默认情况下,ResultSet的类型为TYPE_FORWARD_ONLY。DatabaseMetaData接口中提供了一个supportsResultSetType()方法,用于判断数据库驱动是否支持某种类型的ResultSet对象,如果支持,则返回true,否则返回false。如果JDBC驱动不支持某一类型的ResultSet对象,在调用Connection对象的createStatement()、prepareStatement()或prepareCall()方法指定创建该类型的ResultSet对象时,会在Connection对象中产生一个SQLWarning对象,当Statement对象执行时,产生的ResultSet对象可以通过ResultSet对象的getType()方法确定它的类型。

ResultSet并行性

ResultSet对象的并行性决定了它支持更新的级别,目前JDBC中支持两个级别,分别如下:

CONCUR_READ_ONLY:为ResultSet对象设置这种属性后,只能从ResulSet对象中读取数据,但是不能更新ResultSet对象中的数据。

CONCUR_UPDATABLE:该属性表明,既可以从ResulSet对象中读取数据,又能更新ResultSet中的数据。

ResultSet对象默认并行性为CONCUR_READ_ONLY。DatabaseMetaData接口中提供了一个supportsResultSetConcurrency()方法,用于判断JDBC驱动是否支持某一级别的并行性,如果支持就返回true,否则返回false。

如果JDBC不支持某一级别的并行性,则调用createStatement()、prepareStatement()或prepareCall()方法指定该级别时会在Connection对象中产生一个SQLWarning对象。在应用程序中,可以调用ResultSet对象的getConcurrency()方法获取ResultSet的并行性级别。

ResultSet可保持性

调用Connection对象的commit()方法能够关闭当前事务中创建的ResultSet对象。然而,在某些情况下,这可能不是我们期望的行为。ResultSet对象的holdability属性使得应用程序能够在Connection对象的commit()方法调用后控制ResultSet对象是否关闭。

下面两个常量用于在调用Connection对象的createStatement()、prepareStatement()或prepareCall()方法时指定ResultSet对象的可保持性。

HOLD_CURSORS_OVER_COMMIT:当调用Connection对象的commit()方法时,不关闭当前事务创建的ResultSet对象。

CLOSE_CURSORS_AT_COMMIT:当前事务创建的ResultSet对象在事务提交后会被关闭,对一些应用程序来说,这样能够提升系统性能。

ResultSet对象的默认可保持性取决于具体的驱动实现,DatabaseMetaData接口中提供了getResultSetHoldability()方法用于获取JDBC驱动的默认可保持性。如果JDBC驱动不支持某一级别的可保持性,则调用createStatement()、prepareStatement()或prepareCall()方法指定该级别时,会在Connection对象中产生一个SQLWarning对象,应用程序可以调用ResultSet对象的getHoldability()方法获取ResultSet的可保持性。

ResultSet属性设置

ResultSet的类型、并行性和可保持性等属性可以在调用Connection对象的createStatement()、prepareStatement()或prepareCall()方法创建Statement对象时设置

ResultSet游标移动

ResultSet对象中维护了一个游标,游标指向当前数据行。当ResultSet对象第一次创建时,游标指向数据的第一行。ResultSet接口中提供了一系列的方法,用于操作ResultSet对象中的游标,这些方法的作用如下。

next():游标向前移动一行,如果游标定位到下一行,则返回true;如果游标位于最后一行之后,则返回false。

previous():游标向后移动一行,如果游标定位到上一行,则返回true;如果游标位于第一行之前,则返回false。

first():游标移动到第一行,如果游标定位到第一行,则返回true;如果ResultSet对象中一行数据都没有,则返回false。

last():移动游标到最后一行,如果游标定位到最后一行,则返回true;如果ResultSet不包含任何数据行,则返回false。

beforeFirst():移动游标到ResultSet对象的第一行之前,如果ResultSet对象不包含任何数据行,则该方法不生效。

afterLast():游标位置移动到ResultSet对象最后一行之后,如果ResultSet对象中不包含任何行,则该方法不生效。

relative(int rows):相对于当前位置移动游标,如果参数rows为0,则游标不会移动。如果rows为正数,则游标向前移动指定的行数,如果rows大于当前位置到最后一行的偏移量,则游标移动到最后一行之后。如果rows为负数,则游标向后移动,如果rows大于当前位置到第一行的偏移量,则游标移动到第一行之前的位置。当游标正确定位到某一行时,该方法返回true,否则返回false。如果参数rows值为1,则该方法的效果和next()方法相同;如果rows参数为-1,则该方法的效果和previous()方法相同。

absolute(int row):游标定位到ResultSet对象中的第row行。如果row为正数,则游标移动到ResultSet对象的第row行。需要注意的是,这里行的序数从1开始。如果参数row大于ResultSet对象中的最大行数,则游标移动到最后一行之后。如果参数row为负数,游标从行尾开始移动。例如,row值为-1时,游标移动到最后一行;为-2时,游标移动到倒数第二行;如果row的绝对值大于最大行,则游标移动到第一行之前。

注意:当ResultSet对象的类型为TYPE_FORWARD_ONLY时,游标只能向前移动,调用其他方法操作游标向后移动时将会抛出SQLException异常

修改ResultSet对象

并行性为CONCUR_UPDATABLE的ResultSet对象可以使用ResultSet接口中提供的方法对其进行更新,包括更新行、删除行,在JDBC驱动支持的情况下,还可以插入新的行。

@Test
  public void resultSetTest() throws SQLException {
    Connection connection = DriverManager.getConnection("jdbc:mysql://xxxx/demo",
      "xxxx",
      "xxxx");

    connection.setAutoCommit(false);

    Statement statement = connection.createStatement(
      ResultSet.TYPE_FORWARD_ONLY,
      ResultSet.CONCUR_UPDATABLE);

    ResultSet resultSet = statement.executeQuery("select * from demo1");

    resultSet.next();
    resultSet.updateString("name", "lyj1");
    resultSet.updateRow();

    resultSet.moveToInsertRow();
    resultSet.updateString("name","daitao2");
    resultSet.insertRow();
    
    resultSet.absolute(2);
    resultSet.deleteRow();

    connection.commit();

    resultSet.close();
    statement.close();
    connection.close();
  }
  • 删除数据

    将ResultSet对象的游标定位到某一行后,调用deleteRow()方法会删除数据库中对应的行。这种删除对于一个打开的ResultSet对象是可见的,它会反映到ResultSet对象的变化—ResultSet对象会移除对应的行,或者把对应的行设置为空或无效行。若如此,则调用DatabaseMetaData对象的ownDeletesAreVisible(int type)方法将返回true。如果调用deleteRow()方法删除行后ResultSet对象中仍然包含该行,那么调用DatabaseMetaData对象的ownDeletesAreVisible(int type)方法将返回false,意味着数据删除对当前ResultSet对象不可见。

    将ResultSet对象的游标定位到某一行后,调用deleteRow()方法会删除数据库中对应的行。这种删除对于一个打开的ResultSet对象是可见的,它会反映到ResultSet对象的变化—ResultSet对象会移除对应的行,或者把对应的行设置为空或无效行。若如此,则调用DatabaseMetaData对象的ownDeletesAreVisible(int type)方法将返回true。如果调用deleteRow()方法删除行后ResultSet对象中仍然包含该行,那么调用DatabaseMetaData对象的ownDeletesAreVisible(int type)方法将返回false,意味着数据删除对当前ResultSet对象不可见。

  • 插入数据

    ResultSet对象中插入行需要以下几步:

    (1)移动游标到待插入的位置。

    (2)调用ResultSet接口提供的updateXXX()方法为每一个字段设置值。

    (3)插入行到当前ResultSet对象中。

    需要注意的是,插入行中的每一个字段不允许为null,必须使用合适的updateXXX()方法指定一个确定的值。如果updateXXX()方法指定的值与数据库字段类型不匹配,那么调用insertRow()方法会抛出SQLException异常。如果新插入的行对ResultSet对象可见,那么调用DatabaseMetaData对象的ownInsertsAreVisible(int type)方法时返回true,否则返回false。如果新插入的行对其他事务中的ResultSet对象可见,则调用DatabaseMetaData对象的othersInsertsAreVisible(int type)方法返回true。如果ResultSet对象能够识别新插入的行,那么调用DatabaseMetaData对象的insertsAreDetected(int type)方法将会返回true,意味着插入行对ResultSet对象可见。

  • 更新数据

    如上面的代码所示,执行查询SQL生成ResultSet对象后,调用next()方法将游标定位到第一行,然后调用updateString()方法更新第一行的author字段,接着调用ResultSet的updateRow()方法将ResultSet对象的修改应用到数据库。

    DatabaseMetaData接口中的ownUpdatesAreVisible(int type)方法用于判断指定类型的ResultSet对象的更新是否对当前事务可见,如果可见,就返回true,否则返回false。

    DatabaseMetaData接口的othersUpdatesAreVisible(int type)方法用于判断指定类型的ResultSet对象的更新是否对其他事务可见,如果可见,就返回true,否则返回false。

    ResultSet对象可以调用rowUpdated()方法来判断是否调用了updateRow()方法确认更新。对于任何给定的ResultSet,应用程序不应该在调用updateXXX()方法之后以及在调用后续的updateRow()或cancelRowUpdates()方法之前修改通过updateXXX()方法设置的参数值,否则可能会产生不可预期的效果。

注意:对于一个给定的ResultSet对象,调用updateXXX()方法为每一个字段设置值后,在insertRow()方法调用前,应用程序不可以修改参数值,否则可能产生不可预料的结果。

关闭ResultSet对象

ResultSet对象在下面两种情况下会显式地关闭:

(1)调用ResultSet对象的close()方法。

(2)创建ResultSet对象的Statement或者Connection对象被显式地关闭。

在下面两种情况下ResultSet对象会被隐式地关闭:

(1)相关联的Statement对象重复执行时。

(2)可保持性为CLOSE_CURSORS_AT_COMMIT的ResultSet对象在当前事务提交后会被关闭。

注意:

一些JDBC驱动实现,当ResultSet类型为TYPE_FORWARD_ONLY并且next()方法返回false时,也会隐式地关闭ResultSet对象。一旦ResultSet对象被关闭,调用除isClosed()和close()之外的方法就会抛出SQLException异常,但是通过ResultSet创建的ResultSetMetaData实例仍然可以访问。

ResultSet对象关闭后,不会关闭由ResultSet对象创建的Blob、Clob、NClob或SQLXML对象,除非调用这些对象的free()方法。

注意:摘要于《mybatis3源码深度解析》