java.beans

Class Encoder

java.lang.Object

java.beans.Encoder

已知直接子类：

XMLEncoder

public class Encoder
extends Object

一个 Encoder是一类可用于创建文件或流的编码集JavaBeans国家在其公共API。的 Encoder，与其坚持代表一起，是负责把对象图分解为一系列 Statementss和 Expressions可以用来创建它。子类通常提供一种语法，这些词语的使用一些人类可读的形式像java源代码或XML。

从以下版本开始：

一点四

构造方法摘要

构造方法

Constructor and Description
Encoder()

方法摘要

Modifier and Type	Method and Description
Object	get(Object 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

Constructor Detail

Encoder

public Encoder()

方法详细信息

writeObject

protected void writeObject(Object o)

将指定的对象写入输出流。序列化的形式将表示一系列表达式，其联合作用时将创建一个等效对象输入流读取。默认情况下，该对象被假定为具有默认构造函数的JavaBean，其状态是由配对的“二传手”和“吸气”的方法返回的自省。

参数

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和位于同一个包。

   公共类豆…}公共课beanpersistencedelegate {…}

   的BeanPersistenceDelegate类的实例返回的Bean类。
3. 如果类型是null，共享内部持久委托返回编码null价值。
4. 如果类型是枚举宣言，共享内部持久委托返回编码这个枚举常量的名字。
5. 如果类型是一个原始类型或相应的包装器，则返回一个共享给定类型的值的共享内部持久性委托。
6. 如果该类型是一个数组，则返回一个共享的内部持久性委托，该委托编码适当的类型和长度的数组，以及它的每一个元素，它们都是属性。
7. 如果类型是一个代理，一个共享的内部持久代表返回，编码一个代理实例利用Proxy.newProxyInstance(java.lang.ClassLoader, java.lang.Class<?>[], java.lang.reflect.InvocationHandler)方法。
8. 如果这种类型的BeanInfo已经定义了一个“persistencedelegate”属性BeanDescriptor，此命名属性的返回值。
9. 在所有其他情况下，返回默认的持久性委托。默认的持久性代表假设的类型是一个JavaBean，意味着它具有默认构造函数，它的状态可以通过配对的“二传手”和“吸气”的方法返回的Introspector类。默认构造函数的参数是有ConstructorProperties注释最多的构造函数。如果构造函数没有ConstructorProperties注释，那么默认构造函数（不带参数的构造函数）将被使用。例如，下面的代码片段中，为Foo类的默认构造函数将被使用，而两个参数的构造函数的类将用于Bar。

   公共类Foo {公共foo() {…}公共foo（int x）{…}}公共类酒吧公共bar() {…}“constructorproperties（{“x”}）公共酒吧（int x）{…}“constructorproperties（{“X”、“Y”}）公共酒吧（x，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临时值。一个持久的代表可以利用其 mutatesTo方法确定这个值可能被初始化的输出或是一个新的对象必须重新形成的等效对象的实例化。如果流尚未看到此值，则返回空值。

参数

oldInstance -实例要抬头。

结果

对象，如果对象没有被看到过。

writeStatement

public void writeStatement(Statement oldStm)

声明 oldStm写入到流。的 oldStm应该完全在调用者环境写的，即目标和所有参数应该被写入部分对象图。这些表达式代表了一系列的“发生了什么”的表达式，它告诉输出流如何产生一个像原来的对象图。

该方法的实现将产生一个第二个表达式，以表示在流读取时将存在的环境中的相同的表达式。这是通过调用writeObject对目标和所有的争论和建设成果的新表达的实现。

参数

oldStm -被写入到流中的表达。

writeExpression

public void writeExpression(Expression oldExp)

执行第一个检查，看看是否有这个值的表达式已经被写入。如果不是，表达克隆，使用相同的方法， writeStatement，和这个表达式的值是调和的克隆表达的值通过调用 writeObject。

参数

oldExp -被写入到流中的表达。