java.io
インタフェース Serializable

既知のサブインタフェースの一覧:

Attribute, Attributes, BindingIterator, Control, Current, CustomValue, DataInputStream, DataOutputStream, DomainManager, DSAPrivateKey, DSAPublicKey, ExtendedRequest, ExtendedResponse, Externalizable, IDLEntity, IDLType, IRObject, Key, Name, NamingContext, Policy, PrivateKey, PublicKey, RemoteRef, Repository, RSAPrivateCrtKey, RSAPrivateKey, RSAPublicKey, RunTime, ServerRef, StreamableValue, UnsolicitedNotification, ValueBase

public interface Serializable

クラスの直列化可能性は、java.io.Serializable インタフェースを実装したクラスによって有効になります。このインタフェースを実装していないクラスでは、その状態が直列化または直列化復元されることはありません。直列化可能クラスのサブタイプは、すべてそれ自体が直列化可能です。直列化インタフェースにはメソッドやフィールドはなく、直列化可能であることを識別するためだけに機能します。

非直列化可能クラスのサブタイプを直列化可能にするため、サブタイプでは、スーパータイプの public フィールド、protected フィールド、および (アクセス可能であれば) package フィールドの状態を保存したり復元したりする責任を想定できます。ただし、サブタイプでこの責任を想定できるのは、それが拡張するクラスに、クラスの状態を初期化するためのアクセス可能な引数なしのコンストラクタがある場合だけです。この場合、Serializable クラスを宣言するとエラーになります。エラーは実行時に検出されます。

直列化復元の際は、非直列化可能クラスのフィールドは、そのクラスの public または protected の引数なしのコンストラクタを使って初期化されます。引数なしのコンストラクタは、直列化可能サブクラスからアクセス可能でなければなりません。直列化可能サブクラスのフィールドは、ストリームから復元されます。

オブジェクトグラフの巡回中に、直列化可能インタフェースをサポートしていない可能性のあるオブジェクトに遭遇することがあります。この場合は、NotSerializableException がスローされ、非直列化可能オブジェクトのクラスを識別します。

直列化と直列化復元の際に特殊な扱いが必要なクラスでは、正確に次のようなシグニチャーを持つ特殊なメソッドを実装する必要があります。

 private void writeObject(java.io.ObjectOutputStream out)
     throws IOException
 private void readObject(java.io.ObjectInputStream in)
     throws IOException, ClassNotFoundException;
 

writeObject メソッドでは、その個々のクラスのオブジェクトの状態を書き込む責任があり、対応する readObject メソッドで復元できるようになります。out.defaultWriteObject を呼び出せば、オブジェクトのフィールドを保存するためのデフォルトの機構を呼び出すことができます。そのメソッド自身は、そのスーパークラスまたはサブクラスに属する状態に関与する必要はありません。状態を保存するには、writeObject メソッドを使って個々のフィールドを ObjectOutputStream に書き込むか、または DataOutput でサポートする単純なデータタイプ用のメソッドを使います。

readObject メソッドは、ストリームから読み込んでクラスのフィールドを復元する責任があります。in.defaultReadObject メソッドを呼び出して、そのオブジェクトの非 static フィールドおよび非 transient フィールドを復元するためのデフォルトの機構を呼び出すことができます。defaultReadObject メソッドは、ストリームの情報を使い、現在のオブジェクト内の対応する名前が付けられたフィールドで、ストリームに保存されたオブジェクトのフィールドを指定します。このメソッドは、新しいフィールドを追加するためにクラスが展開される場合を扱います。このメソッド自身は、そのスーパークラスまたはサブクラスに属する状態にそれ自身が関与する必要はありません。状態は、writeObject メソッドを使って個々のフィールドを ObjectOutputStream に書き込むか、または DataOutput でサポートする基本データ型用のメソッドを使うことにより保存します。

ストリームにオブジェクトを書き込むときに使う代替オブジェクトを指定する必要がある直列化可能クラスでは、次のシグニチャーを正確に指定して、この特別なメソッドを実装する必要があります。

 ANY-ACCESS-MODIFIER Object writeReplace() throws ObjectStreamException;
 

この writeReplace メソッドが存在する場合は、直列化でこのメソッドが呼び出されます。また、このメソッドは直列化されるオブジェクトのクラス内で定義されているメソッドからアクセスできます。そのため、このメソッドでは、private、protected、および package-private でアクセスすることができます。このメソッドに対するサブクラスのアクセスについては、java のアクセス可能性規則に準拠します。

代替オブジェクトのインスタンスをストリームから読み込むときにそのオブジェクトを指定する必要のあるクラスでは、次のシグニチャーを正確に指定して、この特別なメソッドを実装する必要があります。

 ANY-ACCESS-MODIFIER Object readResolve() throws ObjectStreamException;
 

この readResolve メソッドは、writeReplace と同じ呼び出し規則とアクセス可能性規則に準拠します。

導入されたバージョン:

JDK1.1

関連項目:

ObjectOutputStream, ObjectInputStream, ObjectOutput, ObjectInput, Externalizable