java.beans

Class Encoder

java.lang.Object

java.beans.Encoder

已知直接子类：

XMLEncoder

public class Encoder
extends Object

Encoder是一个类，可用于创建根据其公共API编码JavaBean集合的状态的文件或流。 Encoder与其持续代表一起负责将对象图分解成一系列可用于创建它的Statements和Expression 。 子类通常使用一些人类可读的形式（如Java源代码或XML）为这些表达式提供语法。

从以下版本开始：

1.4

构造方法摘要

构造方法

Constructor and Description
Encoder()

方法摘要

Modifier and Type	Method and Description
Object	get(Object oldInstance) 在此流创建的 oldInstance中返回oldInstance的临时值。
ExceptionListener	getExceptionListener() 获取此流的异常处理程序。
PersistenceDelegate	getPersistenceDelegate(类<?> type) 返回给定类型的持久代理。
Object	remove(Object oldInstance) 删除此实例的条目，返回旧条目。
void	setExceptionListener(ExceptionListener exceptionListener) 将此流的异常处理程序设置为 exceptionListener 。
void	setPersistenceDelegate(类<?> type, PersistenceDelegate delegate) 将指定的持久性委托与给定类型关联。
void	writeExpression(Expression oldExp) 该实现首先检查是否已经写入了具有该值的表达式。
protected void	writeObject(Object o) 将指定的对象写入输出流。
void	writeStatement(Statement oldStm) 向流写入声明 oldStm 。

Methods inherited from class java.lang.Object

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

构造方法详细信息

Encoder

public Encoder()

方法详细信息

writeObject

protected void writeObject(Object o)

将指定的对象写入输出流。 序列化形式将表示一系列表达式，其组合效果将在读取输入流时创建一个等效对象。 默认情况下，该对象被假定为具有空值构造函数的JavaBean ，其状态由Introspector返回的匹配的“setter”和“getter”方法对。

参数

o - 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(类<?> type)

返回给定类型的持久代理。 持续委托是按顺序应用以下规则计算的：

1. 如果使用setPersistenceDelegate(java.lang.Class<?>, java.beans.PersistenceDelegate)方法将持久代理与给定类型相关联 ，则返回它。
2. 然后由名称由给定类型的完全限定名称和“PersistenceDelegate”后缀组成的名称查找持久代理。 例如， Bean类的持久代理应该命名为BeanPersistenceDelegate并位于同一个包中。

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

   BeanPersistenceDelegate类的实例返回给Bean类。
3. 如果类型为null ，则返回一个共享的内部持久代理，编码null值。
4. 如果类型是一个枚举声明，那么返回一个共享的内部持久性委托，它将通过名称对该枚举的常量进行编码。
5. 如果类型是原始类型或相应的包装器，则返回共享内部持久性委托，该委托对给定类型的值进行编码。
6. 如果类型是数组，则返回共享内部持久性委托，该委托对适当类型和长度的数组进行编码，并将其每个元素视为属性。
7. 如果类型是代理，则返回使用Proxy.newProxyInstance(java.lang.ClassLoader, java.lang.Class<?>[], java.lang.reflect.InvocationHandler)方法对代理实例进行编码的共享内部持久性委托。
8. 如果BeanInfo这种类型有一个BeanDescriptor其定义的“persistenceDelegate”属性，则返回这个命名属性的值。
9. 在所有其他情况下，将返回默认持久代理。 默认持久性委托假定该类型是JavaBean ，这意味着它具有默认构造函数，并且它的状态可以由Introspector类返回的匹配的“setter”和“getter”方法进行表征 。 默认构造函数是具有最大数量参数的构造函数，它具有ConstructorProperties注释。 如果没有一个构造函数具有ConstructorProperties注释，那么将使用nullary构造函数（没有参数的构造函数）。 例如，在下面的代码段，用于在null构造Foo类将被使用，而这两个参数的构造为Bar类将被使用。

     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 - 对象的类

结果

给定类型的持久代理

另请参见：

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

setPersistenceDelegate

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

将指定的持久性委托与给定类型关联。

参数

type - 指定的持久性委托应用于的对象类

delegate - 给定类型的实例的持久代理

另请参见：

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

remove

public Object remove(Object oldInstance)

删除此实例的条目，返回旧条目。

参数

oldInstance - 应该删除的条目。

结果

已删除的条目。

另请参见：

get(java.lang.Object)

get

public Object get(Object oldInstance)

在此流创建的oldInstance中返回oldInstance的暂定值。 持久代理可以使用其mutatesTo方法来确定此值是否可以被初始化以在输出处形成等效对象，或者是否必须重新实例化新对象。 如果流尚未看到此值，则返回null。

参数

oldInstance - 要查找的实例。

结果

对象，如果对象以前没有被看见，则为null。

writeStatement

public void writeStatement(Statement oldStm)

向流中写入声明oldStm 。 oldStm应该完全根据调用者环境进行编写，即目标和所有参数应该是正在写入的对象图的一部分。 这些表达式表示一系列“发生了什么”的表达式，它们告诉输出流如何生成像原始的对象图。

该方法的实现将产生一个第二个表达式，以便在读取流时将存在的环境中表示相同的表达式。 这是通过调用简单地实现writeObject目标和所有参数，并建设有结果的新的表达方式。

参数

oldStm - 要写入流的表达式。

writeExpression

public void writeExpression(Expression oldExp)

该实现首先检查是否已经写入了具有该值的表达式。 如果没有，则使用与writeStatement相同的过程克隆writeStatement ，并且通过调用writeObject将此表达式的值与克隆表达式的值进行writeObject 。

参数

oldExp - 要写入流的表达式。