- 既知のすべての実装クラス:
SerialRef
public interface Ref
Javaプログラミング言語でのSQL
REF
値のマッピングで、データベースのSQL構造化型の値への参照となります。
SQL REF
値は参照可能SQL構造化型のインスタンスを含む表に格納され、各REF
値はその表の1つのインスタンスに対する一意の識別子となります。 インスタンスが参照するSQL構造化型の代わりに、表の列値または構造化型の属性値のどちらかとしてSQL REF
値を使用できます。
SQL REF
値はSQL構造化型への論理ポインタであるため、Ref
オブジェクトもまたデフォルトでは論理ポインタです。 したがって、SQL REF
値をRef
オブジェクトとして取得しても、クライアントの構造化型の属性を生成しません。
Ref
オブジェクトはPreparedStatement.setRef
メソッドを使用してデータベースに格納できます。
JDBCドライバがそのデータ型をサポートする場合は、Ref
インタフェースのすべてのメソッドが完全に実装される必要があります。
- 導入されたバージョン:
- 1.2
- 関連項目:
-
メソッドのサマリー
修飾子と型メソッド説明このRef
オブジェクトが参照する、完全指定されたSQL構造化型のSQL名を取得します。このRef
オブジェクトによって参照されるSQL構造化型インスタンスを取得します。参照されるオブジェクトを取得し、そのオブジェクトを指定された型マップを使用してJava型へマップします。void
このRef
オブジェクトが参照する構造化型値をObject
の指定されたインスタンスに設定します。
-
メソッドの詳細
-
getBaseTypeName
String getBaseTypeName() throws SQLExceptionこのRef
オブジェクトが参照する、完全指定されたSQL構造化型のSQL名を取得します。- 戻り値:
- 参照されるSQL構造化型の、完全指定されたSQL名
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.2
-
getObject
参照されるオブジェクトを取得し、そのオブジェクトを指定された型マップを使用してJava型へマップします。- パラメータ:
map
- 使用するマッピングが格納されているjava.util.Map
オブジェクト(参照されるSQL構造化型の完全指定名とSQL構造化型がマップされるSQLData
実装のクラス・オブジェクト)- 戻り値:
- この
Ref
オブジェクトが参照するSQL構造化型のカスタム・マッピングであるJavaのObject
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
getObject
Object getObject() throws SQLExceptionこのRef
オブジェクトによって参照されるSQL構造化型インスタンスを取得します。 接続の型マップが構造化型のエントリを持つ場合、インスタンスはその型マップで示されるJavaのクラスへカスタム・マッピングされます。 そうでない場合は、構造化型インスタンスはStruct
オブジェクトにマップされます。- 戻り値:
- この
Ref
オブジェクトが参照するSQL構造化型のマッピングであるJavaのObject
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setObject
void setObject(Object value) throws SQLException このRef
オブジェクトが参照する構造化型値をObject
の指定されたインスタンスに設定します。 データベースに送るときに、ドライバはこれをSQL構造化型に変換します。- パラメータ:
value
- このRef
オブジェクトが参照するSQL構造化型インスタンスを表すObject
- 例外:
SQLException
- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException
- JDBCドライバがこのメソッドをサポートしない場合- 導入されたバージョン:
- 1.4
- 関連項目:
-