8.1.2 getArray()
- 〈この項の構成〉
(1) 機能
配列型の列の全配列要素をObject配列として取得します。
(2) 形式
public synchronized Object getArray() throws SQLException
(3) 引数
なし。
(4) 戻り値
Arrayオブジェクト内に保持している配列型のすべての配列要素が，Object配列として返却されます。
返却される配列要素のHADBでのデータ型を次の表に示します。
|
配列要素のHADBのデータ型（要素データ型） |
返却される配列 |
|---|---|
|
BIGINT |
java.lang.Long[] |
|
INTEGER※1 |
java.lang.Integer[] |
|
SMALLINT※2 |
java.lang.Short[] |
|
DECIMALまたはNUMERIC |
java.math.BigDecimal[] |
|
DOUBLE PRECISIONまたはFLOAT |
java.lang.Double[] |
|
REAL |
java.lang.Float[] |
|
CHAR |
java.lang.String[] |
|
VARCHAR |
java.lang.String[] |
|
STRING |
java.lang.String[] |
|
DATE |
java.sql.Date[] |
|
TIME |
java.sql.Time[] |
|
TIMESTAMP WITHOUT TIME ZONE |
java.sql.Timestamp[] |
|
TIMESTAMP WITH TIME ZONE |
java.time.OffsetDateTime[] |
|
BINARY |
java.io.InputStream[] |
|
VARBINARY |
java.io.InputStream[] |
|
BOOLEAN |
java.lang.Boolean[] |
|
UUID |
java.io.InputStream[] |
- 注※1
-
整数データ型のデータ形式がレガシー形式の場合は，java.lang.Long[]が返却されます。
- 注※2
-
整数データ型のデータ形式がレガシー形式の場合は，java.lang.Integer[]が返却されます。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
このArrayオブジェクトを生成したResultSetオブジェクトがクローズされている場合
このArrayオブジェクトを生成したResultSetオブジェクトを生成したStatementオブジェクトがクローズされたことによって，ResultSetオブジェクトがクローズされた場合も含みます。
-
上記のStatementオブジェクトを作成したConnectionオブジェクトがクローズされている場合
-
トランザクションの決着によって，ResultSetオブジェクトが無効になった場合
-
列の値がArray値として取得できない場合
-
JDBCドライバ内でエラーが発生した場合