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

関連項目:

DatabaseMetaData

メソッドの概要

boolean	equals(Object obj) この RowId を指定されたオブジェクトと比較します。
byte[]	getBytes() この java.sql.RowId オブジェクトで指定される SQL ROWID の値を表すバイト配列を返します。
int	hashCode() この RowId オブジェクトに対するハッシュコード値を返します。
String	toString() この java.sql.RowId オブジェクトで指定される SQL ROWID の値を表す String を返します。

メソッドの詳細

equals

boolean equals(Object obj)

この RowId を指定されたオブジェクトと比較します。引数が null でなく、このオブジェクトと同じ ROWID を表す RowId オブジェクトである場合にだけ、結果は true になります。

別の RowId と比較するときは、RowId の起点と有効な寿命の両方を検討することが重要です。どちらも有効で、どちらも同じデータソースの同じテーブルが起点であり、かつこれらが等しい場合、これらは同じ行を識別します。1 つ以上が有効であると保証されなくなった場合、または異なるデータソースや、同じデータソースの異なるテーブルが起点である場合、これらは等しいことがありますが、同じ行を識別しません。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - この RowId オブジェクトと比較される Object

戻り値:

RowId が等しい場合は true、そうでない場合は false

導入されたバージョン:

1.6

関連項目:

Object.hashCode(), Hashtable

getBytes

byte[] getBytes()

この java.sql.RowId オブジェクトで指定される SQL ROWID の値を表すバイト配列を返します。

戻り値:

この java.sql.RowId オブジェクトで指定される ROWID の値を表すバイト配列。長さは、接続を提供するドライバによって決定される

toString

String toString()

この java.sql.RowId オブジェクトで指定される SQL ROWID の値を表す String を返します。

java.sql.Date.toString() が DATE の内容を SQL の DATE リテラル String DATE "2004-03-17" ではなく String "2004-03-17" として返すように、toString() は ROWID リテラルとしてではなく、接続を提供するドライバに特有の形式を使用して ROWID の内容を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

この java.sql.RowId オブジェクトで指定される ROWID の値を表す String。形式は、接続を提供するドライバによって決定される

hashCode

int hashCode()

この RowId オブジェクトに対するハッシュコード値を返します。

オーバーライド:

クラス Object 内の hashCode

戻り値:

RowId のハッシュコード

関連項目:

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