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