java.beans

Кодер класса

java.lang. Объект

java.beans. Кодер

Прямые Известные Подклассы:

XMLEncoder

public class Encoder
extends Object

Encoder class, который может использоваться, чтобы создать файлы или потоки, которые кодируют состояние набора JavaBeans с точки зрения их общедоступных API. Encoder, в соединении с его делегатами персистентности, ответственно за разламывание графа объектов на серия Statementss и Expressions, который может использоваться, чтобы создать это. Подкласс обычно обеспечивает синтаксис для этих выражений, используя некоторую удобочитаемую форму - как исходный код Java или XML.

С тех пор:

1.4

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

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

Конструктор и Описание
Encoder()

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

Модификатор и Тип	Метод и Описание
Объект	get(Object oldInstance) Возвращает предварительное значение для oldInstance в среде, создаваемой этим потоком.
ExceptionListener	getExceptionListener() Получает обработчик исключений для этого потока.
PersistenceDelegate	getPersistenceDelegate(Class<?> type) Возвращает делегата персистентности к данному типу.
Объект	remove(Object oldInstance) Удаляет запись для этого экземпляра, возвращая старую запись.
void	setExceptionListener(ExceptionListener exceptionListener) Устанавливает обработчик исключений для этого потока к exceptionListener.
void	setPersistenceDelegate(Class<?> type, PersistenceDelegate delegate) Связывает указанного делегата персистентности с данным типом.
void	writeExpression(Expression oldExp) Реализация сначала проверяет, чтобы видеть, было ли выражение с этим значением уже записано.
protected void	writeObject(Object o) Запишите указанный объект в поток вывода.
void	writeStatement(Statement oldStm) Оператор записей oldStm к потоку.

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

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

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

Кодер

public Encoder()

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

writeObject

protected void writeObject(Object o)

Запишите указанный объект в поток вывода. Сериализированная форма обозначит серию выражений, совместное воздействие которых создаст эквивалентный объект, когда входной поток будет считан. По умолчанию объектом, как предполагается, является JavaBean с nullary конструктором, состояние которого определяется соответствующими парами методов "метода set" и "метода get", возвращенных Introspector.

Параметры:

o - Объект, который будет записан потоку.

См. Также:

XMLDecoder.readObject()

setExceptionListener

public void setExceptionListener(ExceptionListener exceptionListener)

Устанавливает обработчик исключений для этого потока к exceptionListener. Обработчик исключений уведомляется, когда этот поток ловит восстанавливаемые исключения.

Параметры:

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

См. Также:

getExceptionListener()

getExceptionListener

public ExceptionListener getExceptionListener()

Получает обработчик исключений для этого потока.

Возвраты:

Обработчик исключений для этого потока; возвратит слушателя исключения значения по умолчанию, если это не было явно установлено.

См. Также:

setExceptionListener(java.beans.ExceptionListener)

getPersistenceDelegate

public PersistenceDelegate getPersistenceDelegate(Class<?> type)

Возвращает делегата персистентности к данному типу. Делегат персистентности вычисляется, применяя следующие правила в порядке:

1. Если делегат персистентности связывается с данным типом при использовании setPersistenceDelegate(java.lang.Class<?>, java.beans.PersistenceDelegate) метод это возвращается.
2. Делегат персистентности тогда ищется именем, составленным из полностью определенное имя данного типа и постфикса "PersistenceDelegate". Например, делегат персистентности к Bean class нужно назвать BeanPersistenceDelegate и расположенный в том же самом пакете.

    public class Bean { ... }
    public class BeanPersistenceDelegate { ... }

   Экземпляр BeanPersistenceDelegate class возвращается для Bean class.
3. Если тип null, совместно используемый внутренний делегат персистентности возвращается, который кодирует null значение.
4. Если тип является a enum объявление, совместно используемый внутренний делегат персистентности возвращается, который кодирует константы этого перечисления их именами.
5. Если тип является типом примитива или соответствующей оберткой, совместно используемый внутренний делегат персистентности возвращается, который кодирует значения данного типа.
6. Если тип является массивом, совместно используемый внутренний делегат персистентности возвращается, который кодирует массив соответствующего типа и длины, и каждого из ее элементов, как будто они - свойства.
7. Если тип является прокси, совместно используемый внутренний делегат персистентности возвращается, который кодирует экземпляр прокси при использовании Proxy.newProxyInstance(java.lang.ClassLoader, java.lang.Class<?>[], java.lang.reflect.InvocationHandler) метод.
8. Если BeanInfo поскольку у этого типа есть a BeanDescriptor который определил атрибут "persistenceDelegate", значение этого именованного атрибута возвращается.
9. Во всех других случаях возвращается делегат персистентности значения по умолчанию. Делегат персистентности значения по умолчанию предполагает, что типом является JavaBean, подразумевая, что у него есть конструктор по умолчанию и что его состояние может быть характеризовано соответствующими парами методов "метода set" и "метода get", возвращенных Introspector class. Конструктор по умолчанию является конструктором с самым большим числом параметров, которое имеет ConstructorProperties аннотация. Если ни один из конструкторов не имеет ConstructorProperties аннотация, тогда nullary конструктор (конструктор без параметров) будет использоваться. Например, в следующем фрагменте кода, nullary конструкторе для Foo class будет использоваться, в то время как конструктор с двумя параметрами для Bar class будет использоваться.

    public class Foo {
        public Foo() { ... }
        public Foo(int x) { ... }
    }
    public class Bar {
        public Bar() { ... }
        @ConstructorProperties({"x"})
        public Bar(int x) { ... }
        @ConstructorProperties({"x", "y"})
        public Bar(int x, int y) { ... }
    }

Параметры:

type - class объектов

Возвраты:

делегат персистентности к данному типу

См. Также:

setPersistenceDelegate(java.lang.Class<?>, java.beans.PersistenceDelegate), Introspector.getBeanInfo(java.lang.Class<?>), BeanInfo.getBeanDescriptor()

setPersistenceDelegate

public void setPersistenceDelegate(Class<?> type,
                                   PersistenceDelegate delegate)

Связывает указанного делегата персистентности с данным типом.

Параметры:

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

delegate - делегат персистентности к экземплярам данного типа

См. Также:

getPersistenceDelegate(java.lang.Class<?>), Introspector.getBeanInfo(java.lang.Class<?>), BeanInfo.getBeanDescriptor()

удалить

public Object remove(Object oldInstance)

Удаляет запись для этого экземпляра, возвращая старую запись.

Параметры:

oldInstance - Запись, которая должна быть удалена.

Возвраты:

Запись, которая была удалена.

См. Также:

get(java.lang.Object)

добраться

public Object get(Object oldInstance)

Возвращает предварительное значение для oldInstance в среде, создаваемой этим потоком. Делегат персистентности может использовать mutatesTo метод, чтобы определить, может ли это значение быть инициализировано, чтобы сформировать эквивалентный объект при выводе или нужно ли новый объект инстанцировать заново. Если поток еще не видел это значение, нуль возвращается.

Параметры:

oldInstance - Экземпляр, который будет искаться.

Возвраты:

Объект, нуль, если объект не был замечен прежде.

writeStatement

public void writeStatement(Statement oldStm)

Оператор записей oldStm к потоку. oldStm должен быть записан полностью с точки зрения среды вызывающих сторон, то есть цель и все параметры должны быть частью записанного графа объектов. Эти выражения представляют серию, "что произошло" выражения, которые говорят поток вывода, как произвести граф объектов как оригинал.

Реализация этого метода произведет второе выражение, чтобы представить то же самое выражение в среде, которая будет существовать, когда поток будет считан. Это достигается просто, вызывая writeObject на цели и всех параметрах и создании нового выражения с результатами.

Параметры:

oldStm - Выражение, которое будет записано потоку.

writeExpression

public void writeExpression(Expression oldExp)

Реализация сначала проверяет, чтобы видеть, было ли выражение с этим значением уже записано. В противном случае выражение клонируется, используя ту же самую процедуру как writeStatement, и значение этого выражения согласовывается со значением клонированного выражения, вызывая writeObject.

Параметры:

oldExp - Выражение, которое будет записано потоку.