6.2 ストリーム要素

基本構造では、ストリーム内でオブジェクトを表す必要があります。それぞれの属性は、クラス固有のメソッドによって書かれてから読まれるクラス、フィールド、データによって表されます。ストリームのオブジェクトの表現は、ある文法によって記述することができます。null オブジェクト、新規オブジェクト、クラス、配列、文字列、およびすでにストリームにあるオブジェクトへのバック参照に対し、特別な表現があります。ストリームに書き込まれた各オブジェクトには、このオブジェクトをバック参照するために使用するハンドルが割り当てられます。ハンドルは、0x7E0000 から始めて順次割り当てられます。ストリームがリセットされると、ハンドルは再び 0x7E0000 から始まります。

クラスオブジェクトは ObjectStreamClass オブジェクトによって表されます。

ObjectStreamClass オブジェクトは次の要素によって表されます。

• 互換クラスのストリーム固有識別子 (SUID)
• そのクラスに writeObject/readObject メソッドがあったかどうかを示すフラグ
• 直列化可能フィールドの数
• デフォルトの機構によって直列化される (そのクラスの) フィールドからなる配列。配列とオブジェクトフィールドの場合、フィールドの型は文字列として入れられる
• annotateClass メソッドによって書き込まれる任意指定のブロックデータレコードまたはオブジェクト
• そのスーパータイプの ObjectStreamClass (スーパークラスが直列化可能でなければ null)

文字列はそれらの UTF エンコーディングによって表されます。修正された UTF の現在の仕様と実装では、コード化された文字列の合計の長さは 65535 文字に制限されるので注意が必要です。

配列は次の要素によって表されます。

• それらの ObjectStreamClass オブジェクト
• 要素の数
• 値の順序。値の型はその配列の型に内在している。たとえば、バイト配列の値の型はバイトである

ストリームの新規オブジェクトは次の要素によって表されます。

• そのオブジェクトのもっとも多く派生されたクラス
• そのオブジェクトのそれぞれの直列化可能クラスのデータ (最も高いスーパークラスが最初)。クラスごとに、ストリームには次のものがある
  • 直列化可能フィールド
    「1.5 クラスの直列化可能なフィールドの指定」を参照
  • そのクラスに writeObject/readObject メソッドがあれば、writeObject メソッドによって書き込まれた、プリミティブ型の任意指定のオブジェクトおよび (または) ブロックデータレコードと、それに続いて endBlockData がある場合がある

クラスによって書き込まれたすべてのプリミティブデータは、ブロックデータレコードにバッファリングされ、ラップされます。これは、そのデータが writeObject メソッドの中でストリームに書き込まれたのか、writeObject メソッドの外から直接ストリームに書き込まれたのかには関係ありません。このデータは、対応する readObject メソッドによって読み込むか、ストリームから直接読み込むことができます。writeObject メソッドによって書き込まれたオブジェクトは、前に書き込まれたブロックデータレコードがあればそれを停止し、正規オブジェクト、null、またはバック参照のどれかのうちで、適切なものとして書き込まれます。ブロックデータレコードでは、エラーの回復によって任意指定データを破棄することができます。クラスの中から呼び出された場合には、ストリームはデータやオブジェクトを endBlockData まで破棄することができます。