java.beans

Класс XMLDecoder

java.lang. Объект

java.beans. XMLDecoder

Все Реализованные Интерфейсы:

AutoCloseable

public class XMLDecoder
extends Object
implements AutoCloseable

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

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

Для получения дополнительной информации Вы могли бы также хотеть проверить Долгосрочную Персистентность Компонентов JavaBeans: XML-схема, статья в Соединении Swing.

С тех пор:

1.4

См. Также:

XMLEncoder, ObjectInputStream

Сводка конструктора

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

Конструктор и Описание
XMLDecoder(InputSource is) Создает новый декодер, чтобы проанализировать архивы XML, создаваемые XMLEncoder class.
XMLDecoder(InputStream in) Создает новый входной поток для того, чтобы считать архивы, создаваемые XMLEncoder class.
XMLDecoder(InputStream in, Object owner) Создает новый входной поток для того, чтобы считать архивы, создаваемые XMLEncoder class.
XMLDecoder(InputStream in, Object owner, ExceptionListener exceptionListener) Создает новый входной поток для того, чтобы считать архивы, создаваемые XMLEncoder class.
XMLDecoder(InputStream in, Object owner, ExceptionListener exceptionListener, ClassLoader cl) Создает новый входной поток для того, чтобы считать архивы, создаваемые XMLEncoder class.

Сводка метода

Модификатор и Тип	Метод и Описание
void	close() Этот метод закрывает входной поток, связанный с этим потоком.
static DefaultHandler	createHandler(Object owner, ExceptionListener el, ClassLoader cl) Создает новый обработчик для синтаксического анализатора SAX, который может использоваться, чтобы проанализировать встроенные архивы XML, создаваемые XMLEncoder class.
ExceptionListener	getExceptionListener() Получает обработчик исключений для этого потока.
Объект	getOwner() Получает владельца этого декодера.
Объект	readObject() Читает следующий объект из базового входного потока.
void	setExceptionListener(ExceptionListener exceptionListener) Устанавливает обработчик исключений для этого потока к exceptionListener.
void	setOwner(Object owner) Устанавливает владельца этого декодера к owner.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

XMLDecoder

public XMLDecoder(InputStream in)

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

Параметры:

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

См. Также:

XMLEncoder.XMLEncoder(java.io.OutputStream)

XMLDecoder

public XMLDecoder(InputStream in,
                  Object owner)

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

Параметры:

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

owner - Владелец этого потока.

XMLDecoder

public XMLDecoder(InputStream in,
                  Object owner,
                  ExceptionListener exceptionListener)

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

Параметры:

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

owner - владелец этого потока.

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

XMLDecoder

public XMLDecoder(InputStream in,
                  Object owner,
                  ExceptionListener exceptionListener,
                  ClassLoader cl)

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

Параметры:

in - базовый поток. null может быть передан без ошибки, хотя получающийся XMLDecoder будет бесполезен

owner - владелец этого потока. null юридическое значение

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

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

С тех пор:

1.5

XMLDecoder

public XMLDecoder(InputSource is)

Создает новый декодер, чтобы проанализировать архивы XML, создаваемые XMLEncoder class. Если входной источник is null, никакое исключение не выдается, и никакой парсинг не выполняется. Это поведение подобно поведению других конструкторов то использование InputStream в качестве параметра.

Параметры:

is - входной источник, чтобы проанализировать

С тех пор:

1.7

Деталь метода

близко

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 class. owner должен использоваться, если проанализированный XML-документ содержит вызов метода в пределах контекста <java> элемент. null значение может вызвать недопустимый парсинг в таком случае. Та же самая проблема может произойти, если owner class не содержит ожидаемый метод, чтобы вызвать. См. детали здесь.

Параметры:

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

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

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

Возвраты:

экземпляр DefaultHandler для синтаксического анализатора SAX

С тех пор:

1.7