|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
JDBC 2.0
SQL BLOB
の JavaTM プログラミング言語での表現 (マッピング) です。SQL BLOB
は、バイナリラージオブジェクトをデータベーステーブルの行にカラム値として格納する組み込み型です。ドライバは SQL locator(BLOB)
を使って Blob
を実装します。つまり、Blob
オブジェクトはデータそのものではなく、SQL BLOB
データへの論理ポインタを格納します。Blob
オブジェクトは、それが作成されたトランザクションの期間中に有効です。
ResultSet
、CallableStatement
、PreparedStatement
の各インタフェースのメソッド (getBlob
や setBlob
など) を使うと、プログラマは SQL BLOB
にアクセスできます。Blob
インタフェースは、SQL BLOB
(バイナリラージオブジェクト) 値の長さを取得するためのメソッド、クライアントで BLOB
値を生成するためのメソッド、および BLOB
値でのバイトパターンの位置を判定するためのメソッドを提供します。
メソッドの概要 | |
InputStream |
getBinaryStream()
この Blob インスタンスによって指定された BLOB をストリームとして取り出します。 |
byte[] |
getBytes(long pos,
int length)
この Blob オブジェクトによって指定された BLOB 値の一部または全部をバイト配列として返します。 |
long |
length()
この Blob オブジェクトによって指定された BLOB 値のバイト数を返します。 |
long |
position(Blob pattern,
long start)
この Blob オブジェクトによって指定された BLOB 値内で pattern が始まるバイト位置を判定します。 |
long |
position(byte[] pattern,
long start)
この Blob オブジェクトが表す BLOB 値内で指定されたバイト pattern が始まるバイト位置を判定します。 |
メソッドの詳細 |
public long length() throws SQLException
Blob
オブジェクトによって指定された BLOB
値のバイト数を返します。BLOB
の長さ (バイト単位)BLOB
の長さにアクセスするときにエラーが発生した場合public byte[] getBytes(long pos, int length) throws SQLException
Blob
オブジェクトによって指定された BLOB
値の一部または全部をバイト配列として返します。バイト配列には、pos
の位置から length
の連続するバイト数が格納されます。pos
- BLOB
値内の最初に抽出されるバイトの位置 (序数)。最初のバイトの位置は 1length
- コピー対象の連続するバイトの数Blob
オブジェクトによって指定された BLOB
値内の、pos
の位置から length
の連続するバイト数が格納されている配列BLOB
にアクセスするときにエラーが発生した場合public InputStream getBinaryStream() throws SQLException
Blob
インスタンスによって指定された BLOB
をストリームとして取り出します。BLOB
データを格納するストリームBLOB
にアクセスするときにエラーが発生した場合public long position(byte[] pattern, long start) throws SQLException
Blob
オブジェクトが表す BLOB
値内で指定されたバイト pattern
が始まるバイト位置を判定します。pattern
の検索は、start
の位置から開始されます。pattern
- 検索対象のバイト配列start
- 検索を開始する位置。最初の位置は 1BLOB
にアクセスするときにエラーが発生した場合public long position(Blob pattern, long start) throws SQLException
Blob
オブジェクトによって指定された BLOB
値内で pattern
が始まるバイト位置を判定します。検索は、start
の位置で開始されます。pattern
- 検索対象の BLOB
値を指定する Blob
オブジェクトstart
- 検索を開始する BLOB
値内の位置。最初の位置は 1BLOB
にアクセスするときにエラーが発生した場合
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |