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