XMLDecoder (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.beans
クラス XMLDecoder

java.lang.Object
  java.beans.XMLDecoder

public class XMLDecoder
extends Object
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(java.io.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)