java.beans
類別 XMLDecoder

java.lang.Object
  java.beans.XMLDecoder

public class XMLDecoder
extends Object

XMLDecoder 類別用於讀取使用 XMLEncoder 創建的 XML 文檔，用途類似於 ObjectInputStream。例如，使用者可以使用以下程式碼片段來讀取以 XML 文檔形式（通過 XMLEncoder 類別寫入）定義的第一個物件：

       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)