クラスObjectOutputStream

java.lang.Object

java.io.OutputStream

java.io.ObjectOutputStream

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

Closeable, DataOutput, Flushable, ObjectOutput, ObjectStreamConstants, AutoCloseable

public class ObjectOutputStream extends OutputStream implements ObjectOutput, ObjectStreamConstants

ObjectOutputStreamは、プリミティブ・データ型とJavaオブジェクトのグラフをOutputStreamに書き込みます。 これらのオブジェクトを読み込む(再構築する)にはObjectInputStreamを使います。 オブジェクトの持続的記憶は、そのストリー� のためのファイルを使えば可能です。 ストリー� がネットワーク・ソケット・ストリー� の� �合は、ほかのホストやほかのプロセス上でオブジェクトを再構築することもできます。

ストリー� に書き込めるのはjava.io.Serializableインタフェースをサポートするオブジェクト� けです。 各直列化可能オブジェクトのクラスは、クラスの名前とシグネチャ、オブジェクトのフィールドと配列、および初期オブジェクトから参照されるほかのすべてのオブジェクトのクロージャを含めてコード化されます。

オブジェクトをストリー� に書き込むにはwriteObjectメソッドを使います。 Stringや配列を含む任意のオブジェクトがwriteObjectによって書き込まれます。 複数のオブジェクトまたはプリミティブも、ストリー� への書込みが可能です。 オブジェクトを読み込むときは、対応するObjectInputstreamから同じ型として、かつ書き込まれたときと同じ� �序で読み込まなければいけません。

プリミティブ・データ型をストリー� に書き込むには、DataOutputの適切なメソッドを使います。 Stringを書き込む� �合はwriteUTFメソッドを使います。

オブジェクトのデフォルトの直列化メカニズ� は、オブジェクトのクラス、クラスのシグネチャ、およびすべての非transientおよび非staticフィールドの値を書き込みます。 ほかのオブジェクトへの参照(transientおよびstaticフィールドは除く)があれば、これらのオブジェクトも書き込まれます。 単一オブジェクトへの多重参照は参照共有メカニズ� によりエンコードされ、オブジェクトのグラフを、オリジナルが書き込まれたときの形状に復元することができます。

たとえば、ObjectInputStreamの例で読み取ることができるオブジェクトを書き込む� �合:

     try (FileOutputStream fos = new FileOutputStream("t.tmp");
          ObjectOutputStream oos = new ObjectOutputStream(fos)) {
         oos.writeObject("Today");
         oos.writeObject(LocalDateTime.now());
     } catch (Exception ex) {
         // handle exception
     }

直列化および直列化復元プロセス中に特別な処理を必要とする直列化可能なクラスは、次のシグネチャを持つメソッドを実装する必要があります:

    private void readObject(java.io.ObjectInputStream stream)
        throws IOException, ClassNotFoundException;
    private void writeObject(java.io.ObjectOutputStream stream)
        throws IOException;
    private void readObjectNoData()
        throws ObjectStreamException;

メソッド名、修飾子、戻り型、およびパラメータの数とタイプは、直列化または直列化復元で使用されるメソッドと完全に一致する必要があります。 これらのシグネチャと一致するチェック済例外をスローするためにのみ、メソッドを宣言する必要があります。

writeObjectメソッドは、その特定のクラスのオブジェクトの状態を書き込んで、対応するreadObjectメソッドがオブジェクトの状態を復元できるようにする役割を担います。 このメソッドは、オブジェクトのスーパー・クラスやサブクラスに属する状態に関与する必要はありません。 状態を保存するには、writeObjectメソッドを使って個々のフィールドをObjectOutputStreamに書き込むか、またはDataOutputがサポートするプリミティブ・データ型用のメソッドを使用します。

直列化では、java.io.Serializableインタフェースを実装しないオブジェクトのフィールドは書き込みません。 直列化可能でないオブジェクトのサブクラスを直列化可能にすることができます。 この� �合、直列化可能でないクラスは、そのフィールドを初期化できるようにするため、引数なしのコンストラクタを持つ必要があります。 この� �合、直列化可能でないクラスの状態を保存および復元するのは、サブクラスの責任になります。 そのクラスのフィールドがアクセス可能である(public、package、またはprotected)� �合、あるいは状態の復元に利用できるsetメソッドやgetメソッドがある� �合がしばしばあります。

writeObjectおよびreadObjectメソッドでNotSerializableExceptionをスローするように実装しておくと、オブジェクトの直列化を防止できます。 例外がObjectOutputStreamにキャッチされ、直列化処理が異常終了します。

Externalizableインタフェースを実装すると、オブジェクトの直列化された形式の内容および形式をオブジェクト側が完全に制御することが可能になります。 ExternalizableインタフェースのメソッドであるwriteExternalとreadExternalは、オブジェクトの状態を保存および復元するために呼び出されます。 これらのメソッドは、クラスによって実装された� �合には、ObjectOutputとObjectInputのすべてのメソッドを使って、自身の状態の書き込みおよび読込みを行うことができます。 どのようなバージョンであっても処理できるようにするのは、オブジェクトの責任です。

enum定数の直列化は、通常の直列化可能または外部化可能オブジェクトとは異なります。 enum定数の直列化された形式を構成するのは、その名前� けです。定数のフィールド値は転送されません。 enum定数を直列化するには、その定数のnameメソッドによって返される文字列をObjectOutputStreamで書き込みます。 他の直列化可能または外部化可能オブジェクトと同様に、enum定数は直列化ストリー� にその後出現する後方参照のターゲットとして機能できます。 enum定数を直列化するプロセスをカスタマイズすることはできません。enum型で定義された、クラス固有のwriteObjectメソッドおよびwriteReplaceメソッドは、直列化復元の間は無視されます。 同様に、serialPersistentFieldsまたはserialVersionUIDのフィールド宣言もすべて無視されます。すべてのenum型は0Lで固定されたserialVersionUIDを持ちます。

直列化可能フィールドおよび外部化可能データを除くプリミティブ・データは、ブロック・データ・レコードとしてObjectOutputStreamに書き込まれます。 ブロック・データ・レコードは、ヘッダーとデータで構成されます。 ブロック・データのヘッダーは、マーカーおよびヘッダーに続くバイト数で構成されます。 連続するプリミティブ・データの書込みは、1つのブロック・データ・レコードにマージされます。 ブロック・データ・レコードに使用されるブロック係数は1024バイトです。 各ブロック・データ・レコードは、1024バイトまで埋め込まれるか、ブロック・データ・モードの終了まで書き込まれます。 ObjectOutputStreamのメソッドwriteObject、defaultWriteObject、およびwriteFieldsを呼び出すと、最初に既存のブロック・データ・レコードが終了されます。

レコードの直列化は、通常の直列化可能オブジェクトまたは外部化可能オブジェクトとは異なります。「レコード直列化」を参照してく� さい。

導入されたバージョン:

1.1

外部仕様

• Javaオブジェクト直列化仕様

関連� �目:

• DataOutput
• ObjectInputStream
• Serializable
• Externalizable
• Javaオブジェクト直列化仕様セクション2、"オブジェクト出力クラス"

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
static class	ObjectOutputStream.PutField	ObjectOutputに書き込まれる持続フィールドへのプログラ� によるアクセスを提供します。

フィールドのサマリー

インタフェースjava.io.ObjectStreamConstantsで宣言されているフィールド

baseWireHandle, PROTOCOL_VERSION_1, PROTOCOL_VERSION_2, SC_BLOCK_DATA, SC_ENUM, SC_EXTERNALIZABLE, SC_SERIALIZABLE, SC_WRITE_METHOD, SERIAL_FILTER_PERMISSION, STREAM_MAGIC, STREAM_VERSION, SUBCLASS_IMPLEMENTATION_PERMISSION, SUBSTITUTION_PERMISSION, TC_ARRAY, TC_BASE, TC_BLOCKDATA, TC_BLOCKDATALONG, TC_CLASS, TC_CLASSDESC, TC_ENDBLOCKDATA, TC_ENUM, TC_EXCEPTION, TC_LONGSTRING, TC_MAX, TC_NULL, TC_OBJECT, TC_PROXYCLASSDESC, TC_REFERENCE, TC_RESET, TC_STRING

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

コンストラクタ

修飾子	コンストラクタ	説明
protected	ObjectOutputStream()	ObjectOutputStreamを完全に実装し直すサブクラスが、ObjectOutputStreamのこの実装によって使用されたばかりのprivateデータを割り当てる必要がないようにする手段を提供します。
	ObjectOutputStream(OutputStream out)	指定されたOutputStreamに書き込むObjectOutputStreamを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
protected void	annotateClass(Class<?> cl)	サブクラスは、このメソッドを実装して、クラスのデータをストリー� に保存できるようにすることができます。
protected void	annotateProxyClass(Class<?> cl)	サブクラスはこのメソッドを実装して、ダイナミック・プロキシ・クラスに対する記述子とともにカスタ� ・データをストリー� に� �納します。
void	close()	ストリー� を閉じます。
void	defaultWriteObject()	現在のクラスの非staticおよび非transientのフィールドを、このストリー� に書き込みます。
protected void	drain()	ObjectOutputStream内のバッファリングされているデータをすべて排出します。
protected boolean	enableReplaceObject(boolean enable)	ストリー� に書き込まれたオブジェクトの置換をストリー� で実行できるようにします。
void	flush()	ストリー� をフラッシュします。
ObjectOutputStream.PutField	putFields()	ストリー� に書き込まれる持続フィールドをバッファに� �納するために使用されるオブジェクトを取得します。
protected Object	replaceObject(Object obj)	このメソッドは、直列化の際に、ObjectOutputStreamの信� �できるサブクラスが、あるオブジェクトをほかのオブジェクトに置換できるようにします。
void	reset()	Resetは、ストリー� にすでに書き込まれているオブジェクトの状態を無効にします。
void	useProtocolVersion(int version)	ストリー� の書込み時に使用するストリー� ・プロトコルのバージョンを指定します。
void	write(byte[] buf)	バイト配列を書き込みます。
void	write(byte[] buf, int off, int len)	バイト配列の一部を書き込みます。
void	write(int val)	バイトを書き込みます。
void	writeBoolean(boolean val)	booleanを書き込みます。
void	writeByte(int val)	8ビットbyteを書き込みます。
void	writeBytes(String str)	Stringをバイトの列として書き込みます。
void	writeChar(int val)	16ビットcharを書き込みます。
void	writeChars(String str)	Stringをcharの列として書き込みます。
protected void	writeClassDescriptor(ObjectStreamClass desc)	指定されたクラス記述子をObjectOutputStreamに書き込みます。
void	writeDouble(double val)	64ビットdoubleを書き込みます。
void	writeFields()	バッファに� �納されたフィールドをストリー� に書き込みます。
void	writeFloat(float val)	32ビットfloatを書き込みます。
void	writeInt(int val)	32ビットintを書き込みます。
void	writeLong(long val)	64ビットのlongを書き込みます。
final void	writeObject(Object obj)	指定されたオブジェクトをObjectOutputStreamに書き込みます。
protected void	writeObjectOverride(Object obj)	サブクラスがデフォルトのwriteObjectメソッドをオーバーライドするために使用するメソッドです。
void	writeShort(int val)	16ビットshortを書き込みます。
protected void	writeStreamHeader()	サブクラスが自身のヘッダーをストリー� の前または後ろに追� できるように提供されています。
void	writeUnshared(Object obj)	ObjectOutputStreamに「共有されない」オブジェクトを書き込みます。
void	writeUTF(String str)	このStringのプリミティブ・データを修正UTF-8形式で書き込みます。

クラスjava.io.OutputStreamで宣言されたメソッド

nullOutputStream

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

ObjectOutputStream

public ObjectOutputStream(OutputStream out) throws IOException

指定されたOutputStreamに書き込むObjectOutputStreamを作成します。 このコンストラクタは、直列化ストリー� ・ヘッダーをベースとなるストリー� に書き込みます。このストリー� は呼出し側でた� ちにフラッシュしてく� さい。ObjectInputStreamsを受け取ったコンストラクタは、ヘッダーを読み込むときにブロックするためです。

パラメータ:

out - 書込み先の出力ストリー�

スロー:

IOException - ストリー� ・ヘッダーの書込み中に入出力エラーが発生した� �合

NullPointerException - outがnullである� �合

導入されたバージョン:

1.4

関連� �目:

• ObjectOutputStream()
• putFields()
• ObjectInputStream(InputStream)

ObjectOutputStream

protected ObjectOutputStream() throws IOException

ObjectOutputStreamを完全に実装し直すサブクラスが、ObjectOutputStreamのこの実装によって使用されたばかりのprivateデータを割り当てる必要がないようにする手段を提供します。

スロー:

IOException - このストリー� の作成中に入出力エラーが発生した� �合

メソッドの詳細

useProtocolVersion

public void useProtocolVersion(int version) throws IOException

ストリー� の書込み時に使用するストリー� ・プロトコルのバージョンを指定します。

このルーチンは、現在のバージョンの直列化が、前のバージョンのストリー� 形式と下位互換性のある形式で書き込めるようにするフックを提供します。

下位互換性のない形式がさらに導入されるのを防ぐためにあらゆる努力が行われますが、選択の余地のない� �合もあります。

パラメータ:

version - java.io.ObjectStreamConstantsからProtocolVersionを使用。

スロー:

IllegalStateException - オブジェクトが直列化されたあとに呼び出された� �合。

IllegalArgumentException - 渡されたバージョンが無効な� �合。

IOException - 入出力エラーが発生した� �合

導入されたバージョン:

1.2

関連� �目:

• ObjectStreamConstants.PROTOCOL_VERSION_1
• ObjectStreamConstants.PROTOCOL_VERSION_2

writeObject

public final void writeObject(Object obj) throws IOException

指定されたオブジェクトをObjectOutputStreamに書き込みます。 オブジェクトのクラス、クラスのシグネチャ、クラスの非transientフィールドおよび非staticフィールドの値とそのすべてのスーパー・タイプが書き込まれます。 あるクラスについてデフォルトの直列化は、writeObjectメソッドとreadObjectメソッドを使ってオーバーライドすることができます。 このオブジェクトによって参照されるオブジェクトは中間的に書き込まれ、それによって、完全に同等なオブジェクト・グラフがObjectInputStreamによって再構築されます。

例外は、OutputStreamに関する問題や、直列化すべきではないクラスについてスローされます。 すべての例外は、OutputStreamにとって致命的で、OutputStreamを不確定な状態にします。ストリー� の状態を無視するか回復処理するかを決めるのは呼出し側です。

定義:

writeObject、インタフェースObjectOutput

パラメータ:

obj - 書き込まれるオブジェクト

スロー:

InvalidClassException - 直列化で使用されるクラスになんらかの不具合があった� �合。

NotSerializableException - 直列化の対象オブジェクトがjava.io.Serializableインタフェースを実装していない� �合。

IOException - ベースとなるOutputStreamが例外をスローした� �合。

writeObjectOverride

protected void writeObjectOverride(Object obj) throws IOException

サブクラスがデフォルトのwriteObjectメソッドをオーバーライドするために使用するメソッドです。 このメソッドは、引数なしのprotectedコンストラクタを使用して、ObjectOutputStreamを構築したObjectOutputStreamの信� �できるサブクラスによって呼び出されます。 サブクラスは、修飾子がfinalのオーバーライド・メソッドを提供するとみなされます。

パラメータ:

obj - ベースとなるストリー� に書き込まれるオブジェクト

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

導入されたバージョン:

1.2

関連� �目:

• ObjectOutputStream()
• writeObject(Object)

writeUnshared

public void writeUnshared(Object obj) throws IOException

ObjectOutputStreamに「共有されない」オブジェクトを書き込みます。 このメソッドは、writeObjectと似ています。た� し、直列化されたインスタンスを指す逆参照としてではなく、ストリー� 内で一意の新しいオブジェクトとして書き込みます。 具体的には、次のようになります。

• writeUnsharedを使用して書き込まれたオブジェクトは、そのオブジェクトがストリー� に書き込まれているかどうかにかかわらず、新しく書き込まれたオブジェクト(ストリー� に書き込まれていないオブジェクト)として直列化されます。
• writeUnsharedによって以前に書き込まれたオブジェクトを書き込む際にwriteObjectを使用すると、以前のwriteUnshared操作は、別のオブジェクトの書き込みとして扱われます。 つまり、ObjectOutputStreamは、writeUnsharedの呼出しによって書き込まれたオブジェクト・データへの後方参照を生成しません。

writeUnsharedを介してオブジェクトを書き込むこと自体は、オブジェクトが直列化復元されたときにそのオブジェクトへの一意参照を保証するものではありませんが、1つのオブジェクトがストリー� 内で複数回定義されることは可能になります。そのため、受け取り側がreadUnsharedを複数回呼び出しても衝突が生じません。 ここで説明したルールは、writeUnsharedによって書き込まれた基本レベルのオブジェクト� けに適用され、直列化されるオブジェクトのグラフ内で一時的に参照されるサブオブジェクトには一切適用されません。

パラメータ:

obj - ストリー� に書き込むオブジェクト

スロー:

NotSerializableException - 直列化するグラフ内のオブジェクトがSerializableインタフェースを実装していない� �合

InvalidClassException - 直列化するオブジェクトのクラスに問題がある� �合

IOException - 直列化中に入出力エラーが発生した� �合

導入されたバージョン:

1.4

defaultWriteObject

public void defaultWriteObject() throws IOException

現在のクラスの非staticおよび非transientのフィールドを、このストリー� に書き込みます。 このメソッドを呼び出すことができるのは、直列化が行われているクラスのwriteObjectメソッド� けです。 別の方法で呼び出された� �合はNotActiveExceptionをスローします。

スロー:

IOException - ベースとなるOutputStreamの書込み中に入出力エラーが発生した� �合

putFields

public ObjectOutputStream.PutField putFields() throws IOException

ストリー� に書き込まれる持続フィールドをバッファに� �納するために使用されるオブジェクトを取得します。 フィールドは、writeFieldsメソッドが呼び出されたときにストリー� に書き込まれます。

戻り値:

直列化可能フィールドを保持しているクラスPutfieldのインスタンス

スロー:

IOException - 入出力エラーが発生した� �合

導入されたバージョン:

1.2

writeFields

public void writeFields() throws IOException

バッファに� �納されたフィールドをストリー� に書き込みます。

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

NotActiveException - オブジェクトの状態を書き込むためにクラスのwriteObjectメソッドが呼び出されなかったときに呼び出された� �合。

導入されたバージョン:

1.2

reset

public void reset() throws IOException

Resetは、ストリー� にすでに書き込まれているオブジェクトの状態を無効にします。 新しいObjectOutputStreamと同じ状態にリセットされます。 ストリー� の現在位置にマークが設定され、対応するObjectInputStreamも同じ位置にリセットされます。 以前にストリー� に書き込まれたオブジェクトは、すでにストリー� 内にあるとは解釈されません。 これらのオブジェクトは、ストリー� に再度書き込まれます。

スロー:

IOException - オブジェクトを直列化中にreset()が呼び出された� �合。

annotateClass

protected void annotateClass(Class<?> cl) throws IOException

サブクラスは、このメソッドを実装して、クラスのデータをストリー� に保存できるようにすることができます。 デフォルトではこのメソッドは何も行いません。 ObjectInputStream内で対応するメソッドはresolveClassです。 このメソッドは、ストリー� の一意のクラスそれぞれについて1回� け呼び出されます。 その時点でクラス名とシグネチャはすでにストリー� に書き込まれています。 このメソッドは、ObjectOutputStreamを自由に使って、適切と判断したクラスの任意の表現(クラス・ファイルのバイトなど)を保存できます。 ObjectInputStreamの対応するサブクラスのresolveClassメソッドは、annotateClassによって書き込まれたデータやオブジェクトを読み込み、使用しなければいけません。

パラメータ:

cl - カスタ� ・データに注釈を付けるクラス

スロー:

IOException - ベースとなるOutputStreamが例外をスローした� �合。

annotateProxyClass

protected void annotateProxyClass(Class<?> cl) throws IOException

サブクラスはこのメソッドを実装して、ダイナミック・プロキシ・クラスに対する記述子とともにカスタ� ・データをストリー� に� �納します。

このメソッドはストリー� の一意の各プロキシ・クラス記述子について1回� け呼び出されます。 ObjectOutputStream内のこのメソッドのデフォルト実装は、何も実行しません。

ObjectInputStream内で対応するメソッドはresolveProxyClassです。 このメソッドをオーバーライドするObjectOutputStreamの指定されたサブクラスについては、ObjectInputStream内の対応するサブクラスのresolveProxyClassメソッドが、annotateProxyClassが書き込むデータまたはオブジェクトをすべて読み取る必要があります。

パラメータ:

cl - カスタ� ・データに注釈を付けるプロキシ・クラス

スロー:

IOException - ベースとなるOutputStreamが例外をスローした� �合

導入されたバージョン:

1.3

関連� �目:

• ObjectInputStream.resolveProxyClass(String[])

replaceObject

protected Object replaceObject(Object obj) throws IOException

このメソッドは、直列化の際に、ObjectOutputStreamの信� �できるサブクラスが、あるオブジェクトをほかのオブジェクトに置換できるようにします。 オブジェクトの置換は、enableReplaceObjectが呼び出されるまでは行えません。 enableReplaceObjectメソッドは、オブジェクトの置換を要求しているストリー� が信� �できるかどうかを調べます。 直列化ストリー� に書き込まれる各オブジェクトのうち最初に出現したものは、replaceObjectに渡されます。 それ以降のオブジェクトへの参照は、replaceObjectの元の呼出しによって返されたオブジェクトによって置換されます。 オブジェクトのprivate状態が意図せずに公開されることがないように、replaceObjectを使うのは信� �できるストリー� に限定されます。

ObjectOutputStream.writeObjectメソッドはObjectタイプのパラメータ(Serializableタイプとは異なる)を取り、直列化可能でないオブジェクトが直列化可能オブジェクトに置き換えられるようにします。

サブクラスがオブジェクトを置換する� �合、直列化復元中に補完置換を行うか、または置換されたオブジェクトが参照が� �納されるすべてのフィールドと互換性があることを確認する必要があります。 フィールドまたは配列要� の型のサブクラスではない型のオブジェクトは、例外を発生させることによって直列化を中断し、その結果オブジェクトは� �納されません。

このメソッドは、各オブジェクトが最初に検出されたときに1回� け呼び出されます。 これ以後検出されるそのオブジェクトへの参照は、新しいオブジェクトにリダイレクトされます。 このメソッドは、置換されるオブジェクトまたは元のオブジェクトを返すことになります。

Nullは、置換するオブジェクトとして返すことができますが、nullのかわりにオブジェクトが必要になる可能性があるため、元のオブジェクトへの参照を含むクラスでNullPointerExceptionが発生する可能性があります。

パラメータ:

obj - 置き換えられるオブジェクト

戻り値:

指定されたオブジェクトと置き換えられた代替オブジェクト

スロー:

IOException - ベースとなるOutputStreamが例外をスローした� �合。

enableReplaceObject

protected boolean enableReplaceObject(boolean enable)

ストリー� に書き込まれたオブジェクトの置換をストリー� で実行できるようにします。 有効にすると、直列化されるすべてのオブジェクトに対してreplaceObject(java.lang.Object)メソッドがコールされます。

パラメータ:

enable - 直列化されるすべてのオブジェクトに対してreplaceObjectの使用を有効にする� �合はtrue

戻り値:

このメソッドが呼び出される前の設定

writeStreamHeader

protected void writeStreamHeader() throws IOException

サブクラスが自身のヘッダーをストリー� の前または後ろに追� できるように提供されています。 このメソッドは、マジック番号とバージョン情� �をストリー� に書き込みます。

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeClassDescriptor

protected void writeClassDescriptor(ObjectStreamClass desc) throws IOException

指定されたクラス記述子をObjectOutputStreamに書き込みます。 クラス記述子はストリー� に書き込まれたオブジェクトのクラスを識別する際に使用します。 ObjectOutputStreamのサブクラスでこのメソッドをオーバーライドすることにより、直列化ストリー� にクラス記述子を書き込む方法をカスタマイズできます。 ObjectInputStreamの対応するメソッドreadClassDescriptorをオーバーライドして、クラス記述子をそのカスタ� ・ストリー� 表現から再構成する必要があります。 デフォルトでは、このメソッドは「Javaオブジェクト直列化仕様」で定義された形式に従ってクラス記述子を書き込みます。

このメソッドを呼び出すことができるのは、ObjectOutputStreamのuseProtocolVersionメソッドを呼び出すことによって設定される古い直列化ストリー� 形式をObjectOutputStreamが使用していない� �合のみである点に注意してく� さい。 この直列化ストリー� が古い形式(PROTOCOL_VERSION_1)を使用している� �合、クラス記述子はオーバーライドまたはカスタマイズが不可能な方法で内部的に書き込まれます。

パラメータ:

desc - ストリー� に書き込むクラス記述子

スロー:

IOException - 入出力エラーが発生した� �合。

導入されたバージョン:

1.3

外部仕様

• Javaオブジェクト直列化仕様

関連� �目:

• ObjectInputStream.readClassDescriptor()
• useProtocolVersion(int)
• ObjectStreamConstants.PROTOCOL_VERSION_1

write

public void write(int val) throws IOException

バイトを書き込みます。 このメソッドはバイトが実際に書き込まれるまでブロックします。

定義:

write、インタフェースDataOutput

定義:

write、インタフェースObjectOutput

定義:

write、クラスOutputStream

パラメータ:

val - ストリー� に書き込まれるバイト

スロー:

IOException - 入出力エラーが発生した� �合。

write

public void write(byte[] buf) throws IOException

バイト配列を書き込みます。 このメソッドはバイトが実際に書き込まれるまでブロックします。

定義:

write、インタフェースDataOutput

定義:

write、インタフェースObjectOutput

オーバーライド:

write、クラスOutputStream

パラメータ:

buf - 書き込まれるデータ

スロー:

IOException - 入出力エラーが発生した� �合。

関連� �目:

• OutputStream.write(byte[], int, int)

write

public void write(byte[] buf, int off, int len) throws IOException

バイト配列の一部を書き込みます。

定義:

write、インタフェースDataOutput

定義:

write、インタフェースObjectOutput

オーバーライド:

write、クラスOutputStream

パラメータ:

buf - 書き込まれるデータ

off - データ内の開始オフセット

len - 書き込まれるバイト数

スロー:

IOException - 入出力エラーが発生した� �合。 特に、出力ストリー� が閉じられると、IOExceptionがスローされる。

IndexOutOfBoundsException - offが� の値の� �合、lenが� の値の� �合、あるいはlenがb.length - offより大きい� �合

flush

public void flush() throws IOException

ストリー� をフラッシュします。 このメソッドは、バッファリングされているすべての出力バイトを書き込んで、ベースとなるストリー� を通してフラッシュします。

定義:

flush、インタフェースFlushable

定義:

flush、インタフェースObjectOutput

オーバーライド:

flush、クラスOutputStream

スロー:

IOException - 入出力エラーが発生した� �合。

drain

protected void drain() throws IOException

ObjectOutputStream内のバッファリングされているデータをすべて排出します。 フラッシュと似ていますが、ベースとなるストリー� にフラッシュを伝播しません。

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

close

public void close() throws IOException

ストリー� を閉じます。 ストリー� に関連するすべてのリソースを解放するために、このメソッドを呼び出す必要があります。

定義:

close、インタフェースAutoCloseable

定義:

close、インタフェースCloseable

定義:

close、インタフェースObjectOutput

オーバーライド:

close、クラスOutputStream

スロー:

IOException - 入出力エラーが発生した� �合。

writeBoolean

public void writeBoolean(boolean val) throws IOException

booleanを書き込みます。

定義:

writeBoolean、インタフェースDataOutput

パラメータ:

val - 書き込まれるboolean

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeByte

public void writeByte(int val) throws IOException

8ビットbyteを書き込みます。

定義:

writeByte、インタフェースDataOutput

パラメータ:

val - 書き込まれるバイト値

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeShort

public void writeShort(int val) throws IOException

16ビットshortを書き込みます。

定義:

writeShort、インタフェースDataOutput

パラメータ:

val - 書き込まれるshort値

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeChar

public void writeChar(int val) throws IOException

16ビットcharを書き込みます。

定義:

writeChar、インタフェースDataOutput

パラメータ:

val - 書き込まれるchar値

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeInt

public void writeInt(int val) throws IOException

32ビットintを書き込みます。

定義:

writeInt、インタフェースDataOutput

パラメータ:

val - 書き込まれるint値

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeLong

public void writeLong(long val) throws IOException

64ビットのlongを書き込みます。

定義:

writeLong、インタフェースDataOutput

パラメータ:

val - 書き込まれるlong値

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeFloat

public void writeFloat(float val) throws IOException

32ビットfloatを書き込みます。

定義:

writeFloat、インタフェースDataOutput

パラメータ:

val - 書き込まれるfloat値

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeDouble

public void writeDouble(double val) throws IOException

64ビットdoubleを書き込みます。

定義:

writeDouble、インタフェースDataOutput

パラメータ:

val - 書き込まれるdouble値

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeBytes

public void writeBytes(String str) throws IOException

Stringをバイトの列として書き込みます。

定義:

writeBytes、インタフェースDataOutput

パラメータ:

str - 書き込まれるバイトの文字列

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeChars

public void writeChars(String str) throws IOException

Stringをcharの列として書き込みます。

定義:

writeChars、インタフェースDataOutput

パラメータ:

str - 書き込まれるcharの文字列

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合

writeUTF

public void writeUTF(String str) throws IOException

このStringのプリミティブ・データを修正UTF-8形式で書き込みます。 ストリー� にStringをプリミティブ・データとして書き込むことと、Objectとして書き込むことには大きな違いがあります。 writeObjectによって書き込まれるStringのインスタンスは、最初はStringとしてストリー� に書き込まれます。 それ以降のwriteObject()の呼出しは、文字列への参照をストリー� に書き込みます。

定義:

writeUTF、インタフェースDataOutput

パラメータ:

str - 書き込まれる文字列

スロー:

IOException - ベースとなるストリー� の書込み中に入出力エラーが発生した� �合