|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
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
値でのバイトパターンの位置を判定するためのメソッドを提供します。
このクラスは JDBC 2.0 API で新しく追加されたものです。
メソッドの概要 | |
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
の長さ (バイト単位)SQLException
- BLOB
の長さにアクセスするときにエラーが発生した場合public byte[] getBytes(long pos, int length) throws SQLException
Blob
オブジェクトによって指定された BLOB
値の一部または全部をバイト配列として返します。バイト配列には、pos
の位置から length
の連続するバイト数が格納されます。pos
- BLOB
値内の最初に抽出されるバイトの位置 (序数)。最初のバイトの位置は 1length
- コピー対象の連続するバイトの数Blob
オブジェクトによって指定された BLOB
値内の、pos
の位置から length
の連続するバイト数が格納されている配列SQLException
- BLOB
にアクセスするときにエラーが発生した場合public InputStream getBinaryStream() throws SQLException
Blob
インスタンスによって指定された BLOB
をストリームとして取り出します。BLOB
データを格納するストリームSQLException
- BLOB
にアクセスするときにエラーが発生した場合public long position(byte[] pattern, long start) throws SQLException
Blob
オブジェクトが表す BLOB
値内で指定されたバイト pattern
が始まるバイト位置を判別します。pattern
の検索は、start
の位置から開始されます。pattern
- 検索対象のバイト配列start
- 検索を開始する位置。最初の位置は 1SQLException
- BLOB
にアクセスするときにエラーが発生した場合public long position(Blob pattern, long start) throws SQLException
Blob
オブジェクトによって指定された BLOB
値内で pattern
が始まるバイト位置を判定します。検索は、start
の位置で開始されます。pattern
- 検索対象の BLOB
値を指定する Blob
オブジェクトstart
- 検索を開始する BLOB
値内の位置。最初の位置は 1SQLException
- BLOB
にアクセスするときにエラーが発生した場合
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.