模块  java.sql
软件包  java.sql

Interface RowId

  • public interface RowId
    SQL ROWID值的Java编程语言中的表示（映射）。 SQL ROWID是一种内置类型，其值可以被认为是数据库表中标识的行的地址。 该地址是否合乎逻辑，或者在任何方面，物理是由其原始数据源确定的。

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

    该方法getRowIdLifetime在界面DatabaseMetaData ，可以用于确定是否RowId对象保持有效，其中，该交易的持续时间RowId被创建，其中，所述会话的持续时间RowId ，被创建，或者，有效地用于如只要其标识的行不被删除。 除了在其原始数据源之外指定其有效生命周期的持续时间之外， getRowIdLifetime指定其原始数据源中ROWID值的有效生命周期的持续时间。 在此，它与大对象不同，因为对其原始数据源中的大对象的有效生命周期没有限制。

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

    从以下版本开始：
    1.6
    另请参见：
    DatabaseMetaData

    • 方法摘要

      所有方法  实例方法 抽象方法 
      变量和类型 方法 描述
      boolean equals​(Object obj)
      将此 RowId与指定的对象进行比较。
      byte[] getBytes()
      返回一个字节数组，表示此 java.sql.RowId对象指定的SQL ROWID的值。
      int hashCode()
      返回此 RowId对象的哈希码值。
      String toString()
      返回一个String，表示此 java.sql.RowId对象指定的SQL ROWID的值。

    • 方法详细信息

      • equals

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

        在将RowId与另一个RowId进行比较时，考虑RowId的原点和有效寿命非常重要。 如果两者都有效，并且两者都来自同一数据源上的同一个表，那么如果它们相等，则它们标识同一行; 如果一个或多个不再保证有效，或者它们来自不同的数据源，或同一数据源上的不同表，它们可能相同但仍然不能识别同一行。

        重写：
        equals在类 Object
        参数
        obj - Object比较这个 RowId对象。
        结果
        如果RowId是相同的， RowId true; 否则是假的
        从以下版本开始：
        1.6
        另请参见：
        Object.hashCode() ， HashMap

      • getBytes

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

      • toString

        String toString()
        返回一个String，表示此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
        结果
        一个字符串，其格式是由驾驶员提供的连接，表示所述的值确定 ROWID由该指定 java.sql.RowId对象。