6.3.13 PctoClobクラス
- 説明
-
Javaプログラミング言語でSQL CLOB型を表現するクラスです。SQLのCLOBは、キャラクタ・ラージ・オブジェクトをデータベースの表の行内の列値として格納する組み込みの型です。
ResultSet、CallableStatement、およびPreparedStatementの各インタフェースのメソッド（getClob、setClobなど）を使用すると、SQLのCLOB値にアクセスできます。
- メソッド
-
PctoClobクラスのメソッドの一覧を次の表に示します。
表6‒23 PctoClobクラスのメソッドの一覧 メソッド
説明
getCharacterStream()
このClobオブジェクトによって指定されたCLOB値を、java.io.Readerオブジェクト（または文字のストリーム）として取り出します。
getSubString(long pos, int length)
このClobオブジェクトによって指定されたCLOB値内の指定された部分文字列のコピーを取得します。
- パッケージ名称
jp.co.Hitachi.soft.hmppcto.jdbc.client
(1) getCharacterStream()
- 説明
-
このClobオブジェクトによって指定されたCLOB値を、java.io.Readerオブジェクト（または文字のストリーム）として取り出します。
- 形式
public java.io.Reader getCharacterStream() throws java.sql.SQLException
- 引数
-
なし。
- 戻り値
-
CLOBデータを格納するjava.io.Readerオブジェクトを返します。
- 例外
-
PctoCommunicationFailureException例外とPctoInternalContradictionException例外以外は、ParticipantでJDBC Driverが送出した例外を送出します。
- java.sql.SQLException：
-
CLOB値にアクセスするときにエラーが発生した場合に送出します。
- java.sql.SQLFeatureNotSupportedException：
-
ParticipantのJDBC Driverがこのメソッドをサポートしない場合に送出します。
- PctoCommunicationFailureException：
-
Entity-ServiceとParticipant間の通信に失敗した場合に送出します。
- PctoInternalContradictionException：
-
Participantの内部で障害が発生した場合に送出します。
- PctoTransactionStartException：
-
トランザクションの範囲外で実行されたためトランザクションブランチの開始に失敗した場合に送出します。
(2) getSubString(long pos, int length)
- 説明
-
このClobオブジェクトによって指定されたCLOB値内の指定された部分文字列のコピーを取得します。部分文字列は、引数posに指定された位置から、引数lengthに指定された数の連続する文字です。
- 形式
public java.lang.String getSubString(long pos, int length) throws java.sql.SQLException
- 引数
-
- long pos：
-
抽出される部分文字列の最初の文字を指定します。最初の文字の位置は1です。
- int length：
-
コピーされる連続した文字数を指定します。0以上を指定してください。
- 戻り値
-
このClobオブジェクトによって指定されたCLOB値内の指定された部分文字列であるStringを返します。
- 例外
-
PctoCommunicationFailureException例外とPctoInternalContradictionException例外以外は、ParticipantでJDBC Driverが送出した例外を送出します。
- java.sql.SQLException：
-
次の場合に例外を送出します。
-
CLOB値にアクセスするときにエラーが発生した場合
-
引数posが1より小さいか、または引数lengthが0より小さい場合
-
- java.sql.SQLFeatureNotSupportedException：
-
ParticipantのJDBC Driverがこのメソッドをサポートしない場合に送出します。
- PctoCommunicationFailureException：
-
Entity-ServiceとParticipant間の通信に失敗した場合に送出します。
- PctoInternalContradictionException：
-
Participantの内部で障害が発生した場合に送出します。
- PctoTransactionStartException：
-
トランザクションの範囲外で実行されたためトランザクションブランチの開始に失敗した場合に送出します。