JavaTM Platform
Standard Ed. 6

java.beans
クラス XMLDecoder

java.lang.Object
  上位を拡張 java.beans.XMLDecoder

public class XMLDecoder
extends Object

XMLDecoder クラスは、XMLDecoder で作成された 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)

setOwner

public void setOwner(Object owner)
このデコーダの所有者を owner に設定します。

パラメータ:
owner - このデコーダの所有者
関連項目:
getOwner()

getOwner

public Object getOwner()
このデコーダの所有者を取得します。

戻り値:
このデコーダの所有者
関連項目:
setOwner(java.lang.Object)

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。