Module  java.sql
软件包  java.sql

Interface RowId


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

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

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

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

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

    • 方法摘要

      所有方法  接口方法  抽象方法 
      Modifier and Type 方法 描述
      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进行比较时，这一点很重要。 如果两者都是有效的，并且两者都来自相同数据源上的同一个表，那么如果它们相同，则它们标识相同的行; 如果一个或多个不再被保证是有效的，或者如果它们源于不同的数据源或相同数据源上的不同的表，那么它们可能相等，但是仍然不能识别相同的行。

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

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