XMLDecoder (Java Platform SE 8)

java.lang.Object
- java.beans.XMLDecoder

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

AutoCloseable
```
public class XMLDecoder
extends Object
implements AutoCloseable
```
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(InputSource is)` `XMLEncoder`クラスで作成されたXMLアーカイブを解析するための新しいデコーダを作成します。
`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`クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`close()` このメソッドは、このストリームに関連付けられている入力ストリームをクローズします。
`static DefaultHandler`	`createHandler(Object owner, ExceptionListener el, ClassLoader cl)` `XMLEncoder`クラスで作成されたXML埋込みアーカイブの解析に使用できるSAXパーサー用の新しいハンドラを作成します。
`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
  - XMLDecoder
```
public XMLDecoder(InputSource is)
```
    XMLEncoderクラスで作成されたXMLアーカイブを解析するための新しいデコーダを作成します。入力ソースのisがnullである場合、例外はスローされず、解析は行われません。この動作は、InputStreamをパラメータとして使用するその他のコンストラクタの動作と似ています。
    
    パラメータ:
    
    is - 解析する入力ソース
    
    導入されたバージョン:
    
    1.7
- メソッドの詳細
  - close
```
public void close()
```
    このメソッドは、このストリームに関連付けられている入力ストリームをクローズします。
    
    定義:
    
    close、インタフェース: AutoCloseable
  - 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)
  - createHandler
```
public static DefaultHandler createHandler(Object owner,
                                           ExceptionListener el,
                                           ClassLoader cl)
```
    XMLEncoderクラスで作成されたXML埋込みアーカイブの解析に使用できるSAXパーサー用の新しいハンドラを作成します。解析するXMLドキュメントの<java>要素のコンテキスト内にメソッドの呼出しが含まれている場合は、ownerを使用してください。そのような場合、null値を指定すると、不正な解析が行なわれる場合があります。呼び出されることが想定されるメソッドがownerクラスに含まれていない場合、同じ問題が発生することがあります。詳細は、ここを参照してください。
    
    パラメータ:
    
    owner - <java>要素の値として使用できるデフォルト・ハンドラの所有者
    
    el - このパーサーの例外ハンドラ。またはデフォルトの例外ハンドラを使用する場合はnull
    
    cl - オブジェクトのインスタンスを生成するために使用されるクラス・ローダー。または、デフォルトのクラス・ローダーを使用する場合はnull
    
    戻り値:
    
    SAXパーサーのDefaultHandlerのインスタンス
    
    導入されたバージョン:
    
    1.7

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスXMLDecoder

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

メソッドのサマリー

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

コンストラクタの詳細

XMLDecoder

XMLDecoder

XMLDecoder

XMLDecoder

XMLDecoder

メソッドの詳細

close

setExceptionListener

getExceptionListener

readObject

setOwner

getOwner

createHandler