java.sql
介面 RowId

public interface RowId

SQL ROWID 值在 Java 程式語言中的表示形式（映射）。SQL ROWID 是一種內置型別，其值可視為它標識的行在資料庫表中的一個位址。該位址是邏輯的還是物理的（在某些方面）取決於它的原始資料源。

介面 ResultSet、CallableStatement 和 PreparedStatement 中的方法（如 getRowId 和 setRowId）允許開發人員存取 SQL ROWID 值。RowId 介面提供以 byte 陣列或 String 形式表示 ROWID 值的方法。

介面 DatabaseMetaData 中的方法 getRowIdLifetime 可用於確定 RowId 物件在創建它的事務及Session處理期間是否仍然有效，實際上，也就是用於確定其標識的行未被刪除之前，RowId 是否仍然有效。除指定其原始資料源外的有效生存期之外，getRowIdLifetime 還指定其原始資料源內的 ROWID 值的有效生存期。在這一點上，它不同於大物件，因為原始資料源內大物件的有效生存期沒有限制。

如果 JDBC 驅動程序支持該資料型別，則必須完全實作 RowId 介面中的所有方法。

從以下版本開始：

1.6

另請參見：

DatabaseMetaData

方法摘要

boolean	equals(Object obj) 將此 RowId 與指定物件比較。
byte[]	getBytes() 返回表示此 java.sql.RowId 物件指定的 SQL ROWID 值的 byte 陣列。
int	hashCode() 返回此 RowId 物件的雜湊碼值。
String	toString() 返回表示此 java.sql.RowId 物件指定的 SQL ROWID 值的 String。

方法詳細資訊

equals

boolean equals(Object obj)

將此 RowId 與指定物件比較。當且僅當參數不為 null，並且是一個與此物件表示相同 ROWID 的 RowId 物件時，結果才為 true。

將一個 RowId 與另一個 RowId 比較時，同時考慮它的原始生存期和有效生存期非常重要。如果兩者都有效，並且兩者都來自同一資料源的同一個表，那麼如果它們相等，則標識相同的行；如果它們中有一個或多個不再保證有效，或者它們源自不同的資料源，或同一資料源的不同表，那麼它們可能相等，但仍然不可能標識相同的行。

覆寫：

類別 Object 中的 equals

參數：

obj - 用於比較此 RowId 物件的 Object。

返回：

如果 RowId 相等，則返回 true；否則返回 false

從以下版本開始：

1.6

另請參見：

Object.hashCode(), Hashtable

getBytes

byte[] getBytes()

返回表示此 java.sql.RowId 物件指定的 SQL ROWID 值的 byte 陣列。

返回：

byte 陣列，其長度由提供連接並表示此 java.sql.RowId 物件指定的 ROWID 值的驅動程序決定。

toString

String toString()

返回表示此 java.sql.RowId 物件指定的 SQL ROWID 值的 String。

與 java.sql.Date.toString() 以 String "2004-03-17" 形式而不是 SQL DATE 文字值形式（它可以是 String DATE "2004-03-17"）返回其 DATE 的內容類似，toString() 以特定於提供連接的驅動程序的形式，而不是 ROWID 文字值形式返回其 ROWID 的內容。

覆寫：

類別 Object 中的 toString

返回：

String，其格式由提供連接並表示此 java.sql.RowId 物件指定的 ROWID 值的驅動程序決定。

hashCode

int hashCode()

返回此 RowId 物件的雜湊碼值。

覆寫：

類別 Object 中的 hashCode

返回：

RowId 的雜湊碼

另請參見：

Object.equals(java.lang.Object), Hashtable