XMLDecoder (Java Platform SE 7)

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` クラスで作成されたアーカイブを読み取るための新しい入力ストリームを作成します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`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, 2013, Oracle and/or its affiliates. All rights reserved.

クラス XMLDecoder

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

メソッドのサマリー

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

コンストラクタの詳細

XMLDecoder

XMLDecoder

XMLDecoder

XMLDecoder

XMLDecoder

メソッドの詳細

close

setExceptionListener

getExceptionListener

readObject

setOwner

getOwner

createHandler