8.6.43 getObject(int columnIndex)
- 〈この項の構成〉
(1) 機能
ResultSetオブジェクトの現在行の列の値を，Javaプログラミング言語のObjectで取得します。値を取得する列は，引数で指定します。
(2) 形式
public synchronized Object getObject(int columnIndex) throws SQLException
(3) 引数
- int columnIndex：
-
列番号を指定します。
(4) 戻り値
列値がJavaオブジェクトとして返却されます。
Javaオブジェクトの型は，JDBC仕様で指定されている組み込み型のマッピングに従って，列のSQL型に対応するデフォルトのJavaオブジェクトの型になります。
検索結果と戻り値の関係を次の表に示します。
|
HADBのデータ型 |
検索結果 |
戻り値 |
|---|---|---|
|
ARRAY |
ナル値 |
null |
|
上記以外 |
検索結果を格納したArrayオブジェクト |
|
|
CHAR VARCHAR STRING |
ナル値 |
null |
|
上記以外 |
検索結果 |
|
|
SMALLINT※2 |
ナル値 |
null |
|
上記以外 |
検索結果で生成したShortオブジェクト |
|
|
INTEGER※3 |
ナル値 |
null |
|
上記以外 |
検索結果で生成したIntegerオブジェクト |
|
|
BIGINT |
ナル値 |
null |
|
上記以外 |
検索結果で生成したLongオブジェクト |
|
|
DECIMAL NUMERIC |
ナル値 |
null |
|
上記以外 |
検索結果 |
|
|
REAL |
ナル値 |
null |
|
上記以外 |
検索結果で生成したFloatオブジェクト |
|
|
DOUBLE PRECISION FLOAT |
ナル値 |
null |
|
上記以外 |
検索結果で生成したDoubleオブジェクト |
|
|
DATE |
ナル値 |
null |
|
上記以外 |
検索結果で生成したjava.sql.Dateオブジェクト |
|
|
TIME |
ナル値 |
null |
|
上記以外 |
検索結果で生成したjava.sql.Timeオブジェクト |
|
|
TIMESTAMP WITHOUT TIME ZONE |
ナル値 |
null |
|
上記以外 |
検索結果で生成したjava.sql.Timestampオブジェクト |
|
|
TIMESTAMP WITH TIME ZONE |
ナル値 |
null |
|
上記以外 |
検索結果で生成したjava.time.OffsetDateTimeオブジェクト |
|
|
BINARY VARBINARY |
ナル値 |
null |
|
上記以外 |
検索結果 |
|
|
UUID |
ナル値 |
null |
|
上記以外 |
検索結果で生成したjava.util.UUIDオブジェクト |
|
|
ROW |
ナル値以外※1 |
検索結果 |
|
BOOLEAN |
ナル値 |
null |
|
ナル値以外 |
検索結果で生成したBooleanオブジェクト |
- 注※1
-
検索結果がナル値になることはありません。
- 注※2
-
整数データ型のデータ形式がレガシー形式の場合は，Integerオブジェクトが返却されます。
- 注※3
-
整数データ型のデータ形式がレガシー形式の場合は，Longオブジェクトが返却されます。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
このResultSetオブジェクトがクローズされている場合
このResultSetオブジェクトを生成したStatementオブジェクトがクローズされたことによって，ResultSetオブジェクトがクローズされた場合も含みます。
-
このResultSetオブジェクトを生成したStatementオブジェクトを作成したConnectionがクローズされている場合
-
トランザクションの決着によってResultSetオブジェクトが無効になった場合
-
存在しない列番号を指定した場合
-
JDBCドライバ内でエラーが発生した場合