java.beans

Class PersistenceDelegate

java.lang.Object

java.beans.PersistenceDelegate

已知直接子类：

DefaultPersistenceDelegate

public abstract class PersistenceDelegate
extends Object

的persistencedelegate类需要在类的公共API的方法来表达一个给定的类的实例的状态的责任。而联想与类本身持久的责任是这样做的，例如，由 readObject和 writeObject方法由 ObjectOutputStream，溪流像使用代理模式的 XMLEncoder可以独立地控制自己的课堂行为。通常情况下，类是把这样的信息和公约的最好的地方可以很容易地表示在这个代表团计划，这样做。然而，有时，它是一个小的问题，在一个类中的一个小的问题，防止整个对象图被写入，这可以让应用程序开发人员没有追索权，但试图阴影的问题类在本地或使用替代持久性技术。在这样的情况下，代表团模型给出了一个相对干净的机制，为应用程序开发人员进行干预的序列化过程的所有部分，而不需要修改的类的实现，这是不是应用程序本身的一部分。

除了使用代理模式，这种持久方案不同于传统的序列化方案要求的writeObject方法模拟没有相应的readObject方法。writeObject模拟编码的每个实例在其公开的API，不需要定义readObject模拟由于程序读取序列化的形式是由方法调用的语义定义了java语言规范。打破依赖之间writeObject和readObject实现，这可能会改变在版本，是在使用这种技术免疫类的所指的私人档案实现变化产生的关键因素。

一个持久化委托，可以控制对象的持久性的所有方面，包括：

• 决定是否一个实例可以变异为同一个类的另一个实例。
• 实例化对象，可以通过调用公共构造函数或公共工厂方法。
• 执行对象的初始化。

从以下版本开始：

一点四

另请参见：

XMLEncoder

构造方法摘要

构造方法

Constructor and Description
PersistenceDelegate()

方法摘要

Modifier and Type	Method and Description
protected void	initialize(类<?> type, Object oldInstance, Object newInstance, Encoder out) 产生一系列的副作用，对 newInstance使新实例就相当于 oldInstance报表。
protected abstract Expression	instantiate(Object oldInstance, Encoder out) 返回一个表达式的值是 oldInstance。
protected boolean	mutatesTo(Object oldInstance, Object newInstance) 如果一个 oldInstance等效副本可以通过一系列的陈述 newInstance创建返回true。
void	writeObject(Object oldInstance, Encoder out) 的 writeObject是一个单一的入口点的持久性和由传统模式的代表团 Encoder使用。

Methods inherited from class java.lang.Object

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

Constructor Detail

PersistenceDelegate

public PersistenceDelegate()

方法详细信息

writeObject

public void writeObject(Object oldInstance,
                        Encoder out)

的 writeObject是一个单一的入口点的持久性和由传统模式的代表团 Encoder使用。虽然这种方法不是最终的，它不需要子类在正常情况下。

此实现的第一个检查，看看是否流已经遇到了这个对象。接下来的mutatesTo方法来看看从返回的流，候选人可以变成oldInstance准确复制。如果可以，那initialize方法来执行初始化。如果没有，候选人是从流中删除，并instantiate方法来创建这个对象的一个新的候选。

参数

oldInstance的实例，将由这个表达式创建。

out流-这将是书面表达。

异常

如果是 null out NullPointerException

mutatesTo

protected boolean mutatesTo(Object oldInstance,
                            Object newInstance)

如果一个 oldInstance等效副本可以通过一系列的陈述 newInstance创建返回true。在这种方法的规范，我们所说的等效，修饰的实例在其公共API的相关方法的行为 oldInstance区分。[注：我们用短语相关的方法而不是所有的方法在这里，只因为，是完全正确的，方法如 hashCode和 toString防止大多数类产生的实例]真正区分副本。

如果两个实例的类是相同的默认行为的回报true。

参数

oldInstance -实例被复制。

newInstance的实例，是要修改。

结果

如果一个 newInstance等效副本可以通过一系列的突变 oldInstance创建应用。

instantiate

protected abstract Expression instantiate(Object oldInstance,
                                          Encoder out)

返回一个表达式的值是 oldInstance。这种方法被用来表征构造函数或工厂方法应用于创建特定对象。例如，对于 Field类持久委托 instantiate方法可以定义如下：

域F =（场）oldinstance；返回新的表达（F，F getdeclaringclass()，“GetField”，新的对象[ ] { F. getname() }）；

注意我们声明的返回表达式的值，表达式的值（返回的 getValue）是相同的 oldInstance。

参数

oldInstance的实例，将由这个表达式创建。

out流-这将是书面表达。

结果

一个表达式的值是 oldInstance。

异常

NullPointerException -如果 out是 null，该值用于方法

initialize

protected void initialize(类<?> type,
                          Object oldInstance,
                          Object newInstance,
                          Encoder out)

产生一系列的副作用，对 newInstance使新实例就相当于 oldInstance报表。在这种方法的规范，我们所说的等效，方法返回后，修改后的实例是在其公共API的所有方法的行为 newInstance区分。

实现这一目标的实现是通过制造一系列的“发生了什么”涉及oldInstance及其公开的状态报表。这些陈述是向使用其writeExpression方法返回一个包含一个克隆的环境中读取输入流的状态模拟元素表达的输出流。返回的每一个语句都会有所有的实例旧的环境取代了在新的对象中存在的对象。特别是，对这些语句的目标引用，它开始作为参考oldInstance是作为参考的newInstance而返回。执行这些语句的效果的两个对象的状态的增量对齐作为一系列的修改在新的环境中的对象。在初始化方法返回的时候，它应该是不可能的，通过使用他们的公共的接口来告诉这两个实例。最重要的是，用于使这些对象的步骤的顺序出现相当于将已记录的输出流，并将形成实际输出时，流被刷新。

默认的实现，调用父类的类型的initialize方法。

参数

type -实例的类型

oldInstance -实例被复制。

newInstance的实例，是要修改。

out -流中的任何初始化语句应写。

异常

如果是 null out NullPointerException