目的
このSQLXMLインスタンスが表わすXML値の書き込みに使用されるストリームを取得します。
構文
Writer setCharacterStream()
throws SQLException
戻り値
データを書き込むことができるストリーム。
このストリームの形式は、org.xml.sax.InputSourceによって定義されます。ストリームの文字は、XML 1.0仕様に従ってXMLのUnicodeコード ポイントを表わします。
Unicode以外のエンコーディング宣言が存在する可能性がありますが、ストリームのエンコーディングはUnicodeです。
使用上の注意
ResultSetの指定の列にSQLXMLのjava.sql.Types型がある場合、このメソッドの動作はResultSet.updateCharacterStream()と同じです。
このメソッドを呼び出すとSQL XMLオブジェクトは書き込み不能になり、実装によっては読み取り不能になる場合もあります。
例外
XML値の処理エラーがある場合、SQLExceptionをスローします。例外のgetCause()メソッドは、ストリームに有効な文字が含まれていない場合など、より詳細な例外を提供できます。
状態が書き込み可能でない場合、例外がスローされます。データベース固有コード"9752 (ERRUDFJAVAXML) < Error processing XML value in setCharacterStream>"が返されます。