Класс XMLDecoder

public class XMLDecoder
extends Object
implements AutoCloseable

Класс XMLDecoder используется для чтения XML-документов, созданных с помощью XMLEncoder, и используется так же, как и ObjectInputStream. Например, следующий фрагмент можно использовать для чтения первого объекта, определенного в XML-документе, созданном классом XMLEncoder:

XMLDecoder d = new XMLDecoder(
                          new BufferedInputStream(
                              new FileInputStream("Test.xml")));
       Object result = d.readObject();
       d.close();

Для получения дополнительной информации, вы можете ознакомиться со статьей Долговременное сохранение компонентов JavaBeans: XML-схема в журнале The Swing Connection.

Конструкторы

XMLDecoder

public XMLDecoder(InputStream in)

Создаёт новый поток ввода для чтения архивов, созданных классом XMLEncoder.

Параметры:

in - Базовый поток.

См. также:

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)

Создаёт новый декодер для разбора XML-архивов, созданных классом XMLEncoder. Если источник ввода 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)

Создаёт новый обработчик для парсера SAX, который может использоваться для разбора вложенных XML-архивов, созданных классом XMLEncoder. Обработчик owner должен использоваться, если анализируемый XML-документ содержит вызов метода в контексте элемента <java>. Значение null может вызвать неправильный разбор в таком случае. Та же проблема может возникнуть, если класс owner не содержит ожидаемого вызываемого метода. Подробности см. здесь.

Параметры:

owner - владелец обработчика по умолчанию, который может быть использован в качестве значения элемента <java>

el - обработчик исключений для парсера, или null для использования обработчика исключений по умолчанию

cl - загрузчик классов, используемый для создания объектов, или null для использования стандартного загрузчика классов

Возвращает:

экземпляр DefaultHandler для парсера SAX

С:

1.7