SerialBlob (Java Platform SE 8)

java.lang.Object
- javax.sql.rowset.serial.SerialBlob

すべての実装されたインタフェース:

Serializable、Cloneable、Blob
```
public class SerialBlob
extends Object
implements Blob, Serializable, Cloneable
```
Javaプログラミング言語でのSQL BLOB値の直列化マッピングです。
SerialBlobクラスは、Blobオブジェクトからインスタンスを作成するためのコンストラクタを提供します。 Blobオブジェクトは、SerialBlobオブジェクトを構築する前に、クライアントにSQL BLOB値のデータを渡す必要があります。 SQL BLOB値のデータは、クライアント上で、Blob.getBytesメソッドによってバイト配列として生成されます。または、Blob.getBinaryStreamメソッドによって未解釈のバイト・ストリームとして生成されます。
SerialBlobメソッドは、SerialBlobオブジェクトをバイト配列またはストリームとしてコピーできます。さらに、SerialBlobオブジェクト内で、指定されたバイト・パターンやBlobオブジェクトを検索し、Blobオブジェクトを更新または切り詰めることもできます。
スレッドの安全性

SerialBlobは、複数の並行スレッドによる使用において安全ではありません。複数のスレッドで使用する場合は、適切な同期処理によってSerialBlobへのアクセスを制御するようにしてください。

関連項目:

直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタ	説明
`SerialBlob(Blob blob)`	指定された`Blob`オブジェクトの直列化されたバージョンである`SerialBlob`オブジェクトを構築します。
`SerialBlob(byte[] b)`	指定された`byte`配列の直列化されたバージョンである`SerialBlob`オブジェクトを構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`Object`	`clone()`	この`SerialBlob`のクローンを返します。
`boolean`	`equals(Object obj)`	このSerialBlobを指定されたオブジェクトと比較します。
`void`	`free()`	このメソッドは、`SeriableBlob`オブジェクトを解放して、保持されているリソースを解放します。
`InputStream`	`getBinaryStream()`	この`SerialBlob`オブジェクトを入力ストリームとして返します。
`InputStream`	`getBinaryStream(long pos, long length)`	`Blob`値の一部(バイト位置posから長さlengthバイト分)を格納した`InputStream`オブジェクトを返します。
`byte[]`	`getBytes(long pos, int length)`	この`SerialBlob`オブジェクトの指定の位置から、指定されたバイト数を別のバイト配列にコピーします。
`int`	`hashCode()`	この`SerialBlob`のハッシュ・コードを返します。
`long`	`length()`	この`SerialBlob`オブジェクトのバイト配列のバイト数を取得します。
`long`	`position(Blob pattern, long start)`	この`SerialBlob`オブジェクト内で、指定の`Blob`オブジェクトが開始される位置を返します。検索は指定位置から開始されます。
`long`	`position(byte[] pattern, long start)`	この`SerialBlob`オブジェクト内で、指定されたバイト・パターンが開始される位置を返します。検索は指定位置から開始されます。
`OutputStream`	`setBinaryStream(long pos)`	この`Blob`オブジェクトが表す`BLOB`値への書込みに使用できるストリームを取得します。
`int`	`setBytes(long pos, byte[] bytes)`	この`Blob`オブジェクトが表す`BLOB`値へ指定されたバイト配列を`pos`の位置から書き込み、書き込まれたバイト数を返します。
`int`	`setBytes(long pos, byte[] bytes, int offset, int length)`	この`Blob`オブジェクトが表す`BLOB`値へ指定された`byte`配列の全部または一部を書き込み、書き込まれたバイト数を返します。
`void`	`truncate(long length)`	この`Blob`オブジェクトが表す`BLOB`値を`len`バイトの長さに切り詰めます。

クラス java.lang.Objectから継承されたメソッド
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - SerialBlob
```
public SerialBlob(byte[] b)
           throws SerialException,
                  SQLException
```
    指定されたbyte配列の直列化されたバージョンであるSerialBlobオブジェクトを構築します。
    新しいSerialBlobオブジェクトは、byte配列のデータで初期化されます。このため、未接続のRowSetオブジェクトは、データ・ソースに手を加えずに直列化されたBlobオブジェクトを作成できます。
    
    パラメータ:
    
    b - 直列化されるBlobオブジェクトのデータを格納するbyte配列
    
    例外:
    
    SerialException - 直列化でエラーが発生した場合
    
    SQLException - SQLエラーが発生した場合
  - SerialBlob
```
public SerialBlob(Blob blob)
           throws SerialException,
                  SQLException
```
    指定されたBlobオブジェクトの直列化されたバージョンであるSerialBlobオブジェクトを構築します。
    新しいSerialBlobオブジェクトは、Blobオブジェクトのデータで初期化されます。このため、Blobオブジェクトは、あらかじめデータベースからクライアントへSQL BLOB値のデータを渡しておく必要があります。そうしないと、新しいSerialBlobオブジェクトはデータを持たないオブジェクトになります。
    
    パラメータ:
    
    blob - このSerialBlobオブジェクトの構築に使用されるBlobオブジェクト。null以外。
    
    例外:
    
    SerialException - 直列化でエラーが発生した場合
    
    SQLException - このコンストラクタに渡されたBlobがnullの場合。
    
    関連項目:
    
    Blob
- メソッドの詳細
  - getBytes
```
public byte[] getBytes(long pos,
                       int length)
                throws SerialException
```
    このSerialBlobオブジェクトの指定の位置から、指定されたバイト数を別のバイト配列にコピーします。
    コピーされるバイト数がこのSerialBlobオブジェクトのバイト配列より長くなる場合、配列の長さに合わせて切り詰められます。
    
    定義:
    
    getBytes、インタフェースBlob
    
    パラメータ:
    
    pos - このSerialBlobオブジェクト内のコピーされる最初のバイトの位置。1から開始され、1より小さい値にはならない。また、このSerialBlobオブジェクトの長さ以下でなければならない
    
    length - コピーされるバイト数
    
    戻り値:
    
    このSerialBlobオブジェクトのコピー領域となるバイト配列。指定位置から指定のバイト数分続く
    
    例外:
    
    SerialException - 指定された開始位置が範囲外である場合、またはこのオブジェクトでfreeが以前呼び出された場合
    
    関連項目:
    
    Blob.setBytes(long, byte[])
  - length
```
public long length()
            throws SerialException
```
    このSerialBlobオブジェクトのバイト配列のバイト数を取得します。
    
    定義:
    
    length、インタフェースBlob
    
    戻り値:
    
    このSerialBlobオブジェクトのバイト配列のバイト数を示すlong
    
    例外:
    
    SerialException - エラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
  - getBinaryStream
```
public InputStream getBinaryStream()
                            throws SerialException
```
    このSerialBlobオブジェクトを入力ストリームとして返します。関連メソッドsetBinaryStreamとは異なり、SerialBlobがBlobオブジェクトによって作成されたか、またはbyte配列によって作成されたかに関係なく、ストリームが生成されます。
    
    定義:
    
    getBinaryStream、インタフェースBlob
    
    戻り値:
    
    このSerialBlobのバイト配列を格納するjava.io.InputStreamオブジェクト
    
    例外:
    
    SerialException - エラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
    
    関連項目:
    
    setBinaryStream(long)
  - position
```
public long position(byte[] pattern,
                     long start)
              throws SerialException,
                     SQLException
```
    このSerialBlobオブジェクト内で、指定されたバイト・パターンが開始される位置を返します。検索は指定位置から開始されます。
    
    定義:
    
    position、インタフェースBlob
    
    パラメータ:
    
    pattern - 検索対象のバイト・パターン
    
    start - このSerialBlobオブジェクト内で、検索が開始されるバイトの位置。最初の位置は1。1以上かつ、このSerialBlobオブジェクトの長さ以下でなければならない
    
    戻り値:
    
    このSerialBlobオブジェクト内で、指定されたバイト・パターンが開始される位置。検索は指定位置から開始される。パターンが見つからない場合や開始位置が範囲外にある場合は-1。戻り値の位置番号は1から開始される
    
    例外:
    
    SerialException - Blobの直列化時にエラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
    
    SQLException - データベースからBLOB値にアクセスするときにエラーが発生した場合
  - position
```
public long position(Blob pattern,
                     long start)
              throws SerialException,
                     SQLException
```
    このSerialBlobオブジェクト内で、指定のBlobオブジェクトが開始される位置を返します。検索は指定位置から開始されます。
    
    定義:
    
    position、インタフェースBlob
    
    パラメータ:
    
    pattern - 検索対象のBlobオブジェクト
    
    start - このSerialBlobオブジェクト内で、検索が開始されるバイトの位置。最初の位置は1。1以上かつ、このSerialBlobオブジェクトの長さ以下でなければならない
    
    戻り値:
    
    このSerialBlobオブジェクト内で、指定されたBlobオブジェクトが開始される位置。検索は指定位置から開始される。パターンが見つからない場合や開始位置が範囲外にある場合は-1。戻り値の位置番号は1から開始される
    
    例外:
    
    SerialException - Blobの直列化時にエラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
    
    SQLException - データベースからBLOB値にアクセスするときにエラーが発生した場合
  - setBytes
```
public int setBytes(long pos,
                    byte[] bytes)
             throws SerialException,
                    SQLException
```
    このBlobオブジェクトが表すBLOB値へ指定されたバイト配列をposの位置から書き込み、書き込まれたバイト数を返します。
    
    定義:
    
    setBytes、インタフェースBlob
    
    パラメータ:
    
    pos - 書込みが開始されるSQL BLOB値の位置。最初の位置は1。1以上かつこのSerialBlobオブジェクトの長さ以下でなければならない。
    
    bytes - このBlobオブジェクトを表すBLOB値へ書き込まれるバイト配列
    
    戻り値:
    
    書き込まれるバイト数
    
    例外:
    
    SerialException - BLOB値にアクセスするときにエラーが発生した場合、設定された位置が無効な場合、設定されたオフセット値が無効な場合、またはこのオブジェクトでfreeが以前呼び出された場合
    
    SQLException - データベースからBLOB値にアクセスするときにエラーが発生した場合
    
    関連項目:
    
    getBytes(long, int)
  - setBytes
```
public int setBytes(long pos,
                    byte[] bytes,
                    int offset,
                    int length)
             throws SerialException,
                    SQLException
```
    このBlobオブジェクトが表すBLOB値へ指定されたbyte配列の全部または一部を書き込み、書き込まれたバイト数を返します。書込みは、BLOB値のposの位置から開始され、書込み先の指定されたバイト配列からlenバイト書き込まれます。
    
    定義:
    
    setBytes、インタフェースBlob
    
    パラメータ:
    
    pos - 書込みが開始されるBLOBオブジェクトの位置。最初の位置は1。1以上かつこのSerialBlobオブジェクトの長さ以下でなければならない。
    
    bytes - このBLOB値へ書き込まれるバイト配列
    
    offset - バイトの読込みを開始する、byte配列のオフセット。最初のオフセット位置は0。0以上かつこのbyte配列の長さ以下でなければならない。
    
    length - bytesバイトの配列からBLOB値に書き込まれるバイト数。
    
    戻り値:
    
    書き込まれるバイト数
    
    例外:
    
    SerialException - BLOB値にアクセスするときにエラーが発生した場合、設定された位置が無効な場合、設定されたオフセット値が無効な場合、書き込まれるバイト数がSerialBlobの長さを超えている場合、長さとオフセットを合わせた値がBlobバッファより大きい場合、またはこのオブジェクトでfreeが以前呼び出された場合
    
    SQLException - データベースからBLOB値にアクセスするときにエラーが発生した場合。
    
    関連項目:
    
    getBytes(long, int)
  - setBinaryStream
```
public OutputStream setBinaryStream(long pos)
                             throws SerialException,
                                    SQLException
```
    このBlobオブジェクトが表すBLOB値への書込みに使用できるストリームを取得します。ストリームはposの位置から開始します。このメソッドは、このSerialBlobオブジェクトがBlobによってインスタンス化されている場合に、setBinaryStream()呼出しを配下のBlobに転送します。このSerialBlobがbyte配列によってインスタンス化されている場合はSerialExceptionがスローされます。
    
    定義:
    
    setBinaryStream、インタフェースBlob
    
    パラメータ:
    
    pos - 書込みが開始されるBLOB値の位置。
    
    戻り値:
    
    データが書き込まれるjava.io.OutputStreamオブジェクト
    
    例外:
    
    SQLException - BLOB値にアクセスするときにエラーが発生した場合
    
    SerialException - SerialBlobがsetBinaryStream()をサポートするBlobオブジェクトでインスタンス化されていない場合、またはこのオブジェクトでfreeが以前呼び出された場合
    
    関連項目:
    
    getBinaryStream()
  - truncate
```
public void truncate(long length)
              throws SerialException
```
    このBlobオブジェクトが表すBLOB値をlenバイトの長さに切り詰めます。
    
    定義:
    
    truncate、インタフェースBlob
    
    パラメータ:
    
    length - このBlobオブジェクトが表すBLOB値が切り詰められる長さ(バイト単位)
    
    例外:
    
    SerialException - Blob値にアクセスするときにエラーが発生した場合、切り詰める長さがSerialBlobの長さよりも長い場合、またはこのオブジェクトでfreeが以前呼び出された場合
  - getBinaryStream
```
public InputStream getBinaryStream(long pos,
                                   long length)
                            throws SQLException
```
    Blob値の一部(バイト位置posから長さlengthバイト分)を格納したInputStreamオブジェクトを返します。
    
    定義:
    
    getBinaryStream、インタフェースBlob
    
    パラメータ:
    
    pos - 取得する部分値の最初のバイトまでのオフセット。 Blob内で最初のバイトの位置は1
    
    length - 取得する部分値の長さ(バイト単位)
    
    戻り値:
    
    Blob値の一部を読み取ることのできるInputStream。
    
    例外:
    
    SQLException - posが1より小さい場合、posがBlob内のバイト数より大きい場合、またはpos+lengthがBlob内のバイト数より大きい場合
    
    SerialException - このオブジェクトでfreeメソッドが以前呼び出された場合
    
    導入されたバージョン:
    
    1.6
  - free
```
public void free()
          throws SQLException
```
    このメソッドは、SeriableBlobオブジェクトを解放して、保持されているリソースを解放します。 freeメソッドが一度呼び出されたあとは、オブジェクトは無効になります。
    freeを複数回呼び出した場合、2回目以降のfree呼出しは何も行わないものとして扱われます。
    
    定義:
    
    free、インタフェースBlob
    
    例外:
    
    SQLException - Blobのリソースの解放時にエラーが発生した場合
    
    導入されたバージョン:
    
    1.6
  - equals
```
public boolean equals(Object obj)
```
    このSerialBlobを指定されたオブジェクトと比較します。引数がnullではなく、このオブジェクトと同じ文字シーケンスを表すSerialBlobオブジェクトである場合にのみ、結果はtrueになります。
    
    オーバーライド:
    
    equals、クラスObject
    
    パラメータ:
    
    obj - このSerialBlobと比較するオブジェクト
    
    戻り値:
    
    指定されたオブジェクトがこのSerialBlobに等しいSerialBlobを表す場合はtrue、それ以外の場合はfalse
    
    関連項目:
    
    Object.hashCode(), HashMap
  - hashCode
```
public int hashCode()
```
    このSerialBlobのハッシュ・コードを返します。
    
    オーバーライド:
    
    hashCode、クラスObject
    
    戻り値:
    
    このオブジェクトのハッシュ・コード値
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - clone
```
public Object clone()
```
    このSerialBlobのクローンを返します。コピーは、このSerialBlobオブジェクトの内部バイト配列のクローンへの参照を保持するのであって、元の内部バイト配列への参照を保持するわけではありません。ベースとなるBlobオブジェクトはnullに設定されます。
    
    オーバーライド:
    
    clone、クラスObject
    
    戻り値:
    
    このSerialBlobのクローン
    
    関連項目:
    
    Cloneable

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスSerialBlob

スレッドの安全性

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

SerialBlob

SerialBlob

メソッドの詳細

getBytes

length

getBinaryStream

position

position

setBytes

setBytes

setBinaryStream

truncate

getBinaryStream

free

equals

hashCode

clone