java.beans
クラス XMLDecoder

java.lang.Object
  java.beans.XMLDecoder

public class XMLDecoder
extends Object

XMLDecoder クラスは、XMLEncoder で作成された XML 文書の読み込みに使用できるほか、ObjectInputStream と同様の働きも備えています。たとえば、次のコードでは、XMLEncoder クラスで作成された XML 文書に定義されている最初のオブジェクトを読み取ることができます。

       XMLDecoder d = new XMLDecoder(
                          new BufferedInputStream(
                              new FileInputStream("Test.xml")));
       Object result = d.readObject();
       d.close();
 

詳細については、「The Swing Connection」の「Long Term Persistence of JavaBeans Components: XML Schema」を参照してください。

導入されたバージョン:

1.4

関連項目:

XMLEncoder, ObjectInputStream

コンストラクタの概要

XMLDecoder(InputStream in)
XMLEncoder クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

XMLDecoder(InputStream in, Object owner)
XMLEncoder クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

XMLDecoder(InputStream in, Object owner, ExceptionListener exceptionListener)
XMLEncoder クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

XMLDecoder(InputStream in, Object owner, ExceptionListener exceptionListener, ClassLoader cl)
XMLEncoder クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

メソッドの概要

void	close() このメソッドは、このストリームに関連付けられている入力ストリームをクローズします。
ExceptionListener	getExceptionListener() このストリームの例外ハンドラを取得します。
Object	getOwner() このデコーダの所有者を取得します。
Object	readObject() 基本となる入力ストリームから次のオブジェクトを読み込みます。
void	setExceptionListener(ExceptionListener exceptionListener) このストリームの例外ハンドラを exceptionListener とします。
void	setOwner(Object owner) このデコーダの所有者を owner に設定します。

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

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

コンストラクタの詳細

XMLDecoder

public XMLDecoder(InputStream in)

XMLEncoder クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

パラメータ:

in - 基本となるストリーム

関連項目:

XMLEncoder.XMLEncoder(OutputStream)

XMLDecoder

public XMLDecoder(InputStream in,
                  Object owner)

XMLEncoder クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

パラメータ:

in - 基本となるストリーム

owner - このストリームの所有者

XMLDecoder

public XMLDecoder(InputStream in,
                  Object owner,
                  ExceptionListener exceptionListener)

XMLEncoder クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

パラメータ:

in - 基本となるストリーム

owner - このストリームの所有者

exceptionListener - このストリームの例外ハンドラ。null の場合、デフォルトの例外リスナーが使用される

XMLDecoder

public XMLDecoder(InputStream in,
                  Object owner,
                  ExceptionListener exceptionListener,
                  ClassLoader cl)

XMLEncoder クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

パラメータ:

in - 基本となるストリーム。null がエラーなく引き渡される場合もあるが、結果として得られる XMLDecoder は使いものにならない

owner - このストリームの所有者。有効値は null

exceptionListener - このストリームの例外ハンドラ。デフォルトを使用する場合は null

cl - オブジェクトのインスタンス化に使用するクラスローダ。デフォルトのクラスローダを使用しなければならない場合は null

導入されたバージョン:

1.5

メソッドの詳細

close

public void close()

このメソッドは、このストリームに関連付けられている入力ストリームをクローズします。

setExceptionListener

public void setExceptionListener(ExceptionListener exceptionListener)

このストリームの例外ハンドラを exceptionListener とします。このストリームが回復可能な例外をキャッチすると、この例外ハンドラに通知されます。

パラメータ:

exceptionListener - このストリームの例外ハンドラ。null の場合、デフォルトの例外リスナーが使用される

関連項目:

getExceptionListener()

getExceptionListener

public ExceptionListener getExceptionListener()

このストリームの例外ハンドラを取得します。

戻り値:

このストリームの例外ハンドラ。明示的に設定されていない場合は、デフォルトの例外リスナーが返される

関連項目:

setExceptionListener(java.beans.ExceptionListener)

readObject

public Object readObject()

基本となる入力ストリームから次のオブジェクトを読み込みます。

戻り値:

読み込まれる次のオブジェクト

例外:

ArrayIndexOutOfBoundsException - ストリームに (これ以上) オブジェクトが含まれていない場合

関連項目:

XMLEncoder.writeObject(java.lang.Object)

setOwner

public void setOwner(Object owner)

このデコーダの所有者を owner に設定します。

パラメータ:

owner - このデコーダの所有者

関連項目:

getOwner()

getOwner

public Object getOwner()

このデコーダの所有者を取得します。

戻り値:

このデコーダの所有者

関連項目:

setOwner(java.lang.Object)