JavaTM 2 Platform
Standard Ed. 5.0

java.beans
类 DefaultPersistenceDelegate

java.lang.Object
  继承者 java.beans.PersistenceDelegate
      继承者 java.beans.DefaultPersistenceDelegate

public class DefaultPersistenceDelegate
extends PersistenceDelegate

DefaultPersistenceDelegatePersistenceDelegate 抽象类的具体实现,是没有关于其可用信息的类在默认情况下使用的委托。DefaultPersistenceDelegate 为遵从 JavaBeans 惯例的类提供可恢复的、基于公共 API 的持久性,而无需任何特定于类的配置。

关键假定是:该类有一个 null 构造方法,并通过按照 Introspector 返回的顺序匹配 "setter" 和 "getter" 方法对来精确地表示其状态。除了为 JavaBeans 提供无需编写代码的持久性,对于那些构造方法为非 null 时只需要将一些属性值作为参数的类,DefaultPersistenceDelegate 提供了一个实现持久存储的便捷方法。

从以下版本开始:
1.4
另请参见:
DefaultPersistenceDelegate(String[]), Introspector

构造方法摘要
DefaultPersistenceDelegate()
          为具有 null 构造方法的类创建持久委托。
DefaultPersistenceDelegate(String[] constructorPropertyNames)
          为其构造方法的参数是属性名称值(由 constructorPropertyNames 指定)的类创建默认持久委托。
 
方法摘要
protected  void initialize(Class<?> type, Object oldInstance, Object newInstance, Encoder out)
          initialize 方法的此默认实现假设保存在此类型的对象中的所有状态都是通过匹配 "setter" 和 "getter" 方法对来公开的,公开的顺序是 Introspector 返回它们的顺序。
protected  Expression instantiate(Object oldInstance, Encoder out)
          instantiate 方法的此默认实现返回一个表达式,该表达式包含预先定义的方法名称 "new",该名称表示调用带有参数(在 DefaultPersistenceDelegate 的构造方法中指定)的构造方法。
protected  boolean mutatesTo(Object oldInstance, Object newInstance)
          如果指定构造方法中的参数数量不为零,且 oldInstance 的类显式声明了一个 "equals" 方法,则此方法返回 oldInstance.equals(newInstance) 的值。
 
从类 java.beans.PersistenceDelegate 继承的方法
writeObject
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

DefaultPersistenceDelegate

public DefaultPersistenceDelegate()
为具有 null 构造方法的类创建持久委托。

另请参见:
DefaultPersistenceDelegate(java.lang.String[])

DefaultPersistenceDelegate

public DefaultPersistenceDelegate(String[] constructorPropertyNames)
为其构造方法的参数是属性名称值(由 constructorPropertyNames 指定)的类创建默认持久委托。构造方法参数是通过按提供顺序对属性名称求值来创建的。要使用此类指定特定类型的序列化中使用的单个首选构造方法,需要声明组成构造方法参数的属性的名称。例如,没有定义 null 构造方法的 Font 类可以使用以下持久委托来处理:
     new DefaultPersistenceDelegate(new String[]{"name", "style", "size"});
 

参数:
constructorPropertyNames - 此构造方法的参数的属性名称。
另请参见:
instantiate(java.lang.Object, java.beans.Encoder)
方法详细信息

mutatesTo

protected boolean mutatesTo(Object oldInstance,
                            Object newInstance)
如果指定构造方法中的参数数量不为零,且 oldInstance 的类显式声明了一个 "equals" 方法,则此方法返回 oldInstance.equals(newInstance) 的值。否则,此方法使用超类的定义,即在两个实例的类相等的情况下返回 true。

覆盖:
PersistenceDelegate 中的 mutatesTo
参数:
oldInstance - 要复制的实例。
newInstance - 要修改的实例。
返回:
如果通过对 oldInstance 施加一系列变换可以创建 newInstance 的等效副本,则返回 true。
另请参见:
DefaultPersistenceDelegate(String[])

instantiate

protected Expression instantiate(Object oldInstance,
                                 Encoder out)
instantiate 方法的此默认实现返回一个表达式,该表达式包含预先定义的方法名称 "new",该名称表示调用带有参数(在 DefaultPersistenceDelegate 的构造方法中指定)的构造方法。

指定者:
PersistenceDelegate 中的 instantiate
参数:
oldInstance - 要实例化的实例。
out - 代码输出流。
返回:
值为 oldInstance 的一个表达式。
另请参见:
DefaultPersistenceDelegate(String[])

initialize

protected void initialize(Class<?> type,
                          Object oldInstance,
                          Object newInstance,
                          Encoder out)
initialize 方法的此默认实现假设保存在此类型的对象中的所有状态都是通过匹配 "setter" 和 "getter" 方法对来公开的,公开的顺序是 Introspector 返回它们的顺序。如果属性描述符使用等于 Boolean.TRUE 的值来定义一个 "transient"(瞬态)属性,则此默认实现将忽略该属性。注意,单词 "transient" 的使用完全独立于 ObjectOutputStream 使用的字段修饰符。

对于每个非瞬态属性,创建一个表达式,在其中将非 null "getter" 方法应用于 oldInstance。此表达式的值是将被序列化的实例中的属性值。如果在复制环境中此表达式的值 mutatesTo 目标值,则将初始化新的值,使其等于旧的值。在这种情况下,因为属性值没有发生更改,所以不需要调用相应的 "setter" 方法,也不需要发出声明。不然的话此值的表达式就会被另一个表达式(通常是一个构造方法)替代,并且要调用相应的 "setter" 方法,在对象中安装新属性值。此方案使用此代理从流生成的输出中移除默认信息。

在将这些语句传递到输出流(这些语句将在其中执行)时,newInstance 将产生副作用。在大多数情况下,这允许其值相互依赖的属性的问题通过减少需要写入到输出的语句量来实际帮助序列化过程。通常,处理相互依赖的属性问题被归结为这样一个问题:找出类中属性的某种顺序,从而没有任何属性依赖后续属性的值。

覆盖:
PersistenceDelegate 中的 initialize
参数:
oldInstance - 要复制的实例。
newInstance - 需修改的实例。
out - 所有的初始化语句都应该写入其中的流。
另请参见:
Introspector.getBeanInfo(java.lang.Class), PropertyDescriptor

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策