8.6.24 getCharacterStream(String columnName)
- 〈この項の構成〉
(1) 機能
ResultSetオブジェクトの現在行の列の値をjava.io.Readerオブジェクトに取得します。値を取得する列は，引数で指定します。
(2) 形式
public synchronized Reader getCharacterStream(String columnName) throws SQLException
(3) 引数
- String columnName：
-
列名を指定します。
(4) 戻り値
列値を格納したjava.io.Readerオブジェクトが返却されます。検索結果と戻り値の関係については，「表8‒30 検索結果と戻り値の関係（getCharacterStreamメソッドの場合）」を参照してください。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
このResultSetオブジェクトがクローズされている場合
このResultSetオブジェクトを生成したStatementオブジェクトがクローズされたことによって，ResultSetオブジェクトがクローズされた場合も含みます。
-
このResultSetオブジェクトを生成したStatementオブジェクトを作成したConnectionがクローズされている場合
-
トランザクションの決着によってResultSetオブジェクトが無効になった場合
-
存在しない列名を指定した場合
-
このメソッドでは取得できないデータ型の場合
-
エンコードに失敗した場合
-
JDBCドライバ内でエラーが発生した場合