このBlobオブジェクトが表わす、BLOB値のすべてまたは一部をバイトの配列として取得します。
引数
| 引数 | 説明 |
|---|---|
| pos | 抽出されるBLOB値の最初のバイトの序数の位置。 最初のバイトは位置1にあります。 |
| length | コピーされる連続バイト数。 |
戻り値
結果のバイト配列には、位置lengthのバイトから始まり、このBlobオブジェクトによって指定されるBLOB値から最大でposまでの連続バイトが含まれます。
pos + length - 1がバイト単位のBLOBの長さより大きい場合、結果のバイト配列の長さはlengthより小さくなります。
例外
| 条件 | getBytes()がSQLExceptionをスローする目的 | |||
|---|---|---|---|---|
| BLOB値にアクセスする際にエラーが発生する | LOBデータの読み取り中に予期しないエラーが発生したことを示し、SQLExceptionフィールドを以下のように設定します。
|
|||
| pos引数の値が1より小さい または length引数の値が負である |
無効な引数であることを示し、SQLExceptionフィールドを以下のように設定します。
|
|||
| length引数の値が現在のJVMに対して大きすぎるため、このメソッドで必要なメモリを割り当てることができない | JVMヒープ メモリが使い尽くされたことを示し、SQLExceptionフィールドを以下のように設定します。
|
|||