Module java.sql
Package java.sql

Interface RowId

public interface RowId
Java编程语言中对SQL ROWID值的表示（映射）。SQL ROWID是一种内置类型，其值可以被视为数据库表中其标识行的地址。该地址是逻辑的还是在某些方面是物理的，取决于其来源数据源。

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

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

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

自版本:
1.6
参见:

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    equals(Object obj)
    将此RowId与指定对象进行比较。
    byte[]
    getBytes()
    返回表示由此java.sql.RowId对象指定的SQL ROWID值的字节数组。
    int
    hashCode()
    返回此RowId对象的哈希码值。
    String
    toString()
    返回表示由此java.sql.RowId对象指定的SQL ROWID值的字符串。

  • Method Details

    • equals

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

      在比较RowId与另一个RowId时，考虑其来源和有效生命周期是很重要的。如果两者都有效，并且都来自同一数据源上的同一表，则如果它们相等，则它们标识相同的行；如果一个或多个不再保证有效，或者它们来自不同的数据源，或者来自同一数据源上的不同表，则它们可能相等但仍然不标识相同的行。

      覆盖:
      equals 在类 Object
      参数:
      obj - 要将此RowId对象与之比较的Object。
      返回:
      如果RowId相等，则返回true；否则返回false
      自版本:
      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文字（它将是String DATE“2004-03-17”），toString()返回其ROWID的内容以特定于提供连接的驱动程序的形式，可能不是ROWID文字。

      覆盖:
      toString 在类 Object
      返回:
      由提供连接的驱动程序确定格式的字符串，表示由此java.sql.RowId对象指定的ROWID的值。

    • hashCode

      int hashCode()
      返回此RowId对象的哈希码值。
      覆盖:
      hashCode 在类 Object
      返回:
      RowId的哈希码
      参见: