模块 java.sql
包 java.sql

接口 RowId

public interface RowId
SQL ROWID 值在 Java 编程语言中的表示（映射）。 SQL ROWID 是一种内置类型，它的值可以被认为是它在数据库表中标识的行的地址。该地址是逻辑地址还是物理地址，由其原始数据源决定。

接口 ResultSet、CallableStatement 和 PreparedStatement 中的方法，例如 getRowId 和 setRowId 允许程序员访问 SQL ROWID 值。 RowId 接口提供了一种将 ROWID 的值表示为字节数组或 String 的方法。

接口 DatabaseMetaData 中的方法 getRowIdLifetime 可用于确定 RowId 对象在创建 RowId 的事务期间、创建 RowId 的会话期间是否保持有效，或者，有效地，对于只要其标识的行未被删除。除了在其原始数据源之外指定其有效生命周期的持续时间之外，getRowIdLifetime 还指定了ROWID 值在其原始数据源中的有效生命周期的持续时间。在这一点上，它不同于大对象，因为大对象在其原始数据源中的有效生命周期没有限制。

如果 JDBC 驱动程序支持该数据类型，则必须完全实现 RowId 接口上的所有方法。

自从：
1.6
参见：

  • 方法总结

    修饰符和类型
    方法
    描述
    boolean
    equals(Object obj)
    将此 RowId 与指定对象进行比较。
    byte[]
    getBytes()
    返回表示此 java.sql.RowId 对象指定的 SQL ROWID 值的字节数组。
    int
    hashCode()
    返回此 RowId 对象的哈希码值。
    String
    toString()
    返回表示此 java.sql.RowId 对象指定的 SQL ROWID 值的字符串。

  • 方法详情

    • equals

      boolean equals(Object  obj)
      将此 RowId 与指定对象进行比较。结果是 true 当且仅当参数不为 null 并且是表示与此对象相同的 ROWID 的 RowId 对象。

      将 RowId 与另一个 RowId 进行比较时，务必同时考虑 RowId 的来源和有效生命周期。如果两者都有效，并且都来自同一数据源的同一张表，那么如果它们相等，则它们标识同一行；否则如果一个或多个不再保证有效，或者如果它们来自不同的数据源，或同一数据源上的不同表，它们可能相等但仍然不标识同一行。

      重写：
      equals 在类 Object 中
      参数：
      obj - 与此 RowId 对象进行比较的 Object。
      返回：
      如果 RowId 相等则为真；否则为假
      自从：
      1.6
      参见：

    • getBytes

      byte[] getBytes()
      返回表示此 java.sql.RowId 对象指定的 SQL ROWID 值的字节数组。
      返回：
      字节数组，其长度由提供连接的驱动程序确定，表示此 java.sql.RowId 对象指定的 ROWID 的值。

    • toString

      String  toString()
      返回表示此 java.sql.RowId 对象指定的 SQL ROWID 值的字符串。

      就像 java.sql.Date.toString() 将其 DATE 的内容返回为 String“2004-03-17”而不是 SQL 中的 DATE 文字（本来是 StringDATE“2004-03-17”），toString() 返回其内容ROWID 以特定于提供连接的驱动程序的形式存在，可能不是 ROWID 文字。

      重写：
      toString 在类 Object 中
      返回：
      一个字符串，其格式由提供连接的驱动程序确定，表示此 java.sql.RowId 对象指定的 ROWID 的值。

    • hashCode

      int hashCode()
      返回此 RowId 对象的哈希码值。
      重写：
      hashCode 在类 Object 中
      返回：
      RowId 的哈希码
      参见：