Class PainterUtil.RenderingHintsDelegate

  extended by java.beans.PersistenceDelegate
      extended by org.jdesktop.swingx.editors.PainterUtil.RenderingHintsDelegate
Enclosing class:

public static final class PainterUtil.RenderingHintsDelegate
extends PersistenceDelegate

Constructor Summary
Method Summary
protected  void initialize(Class<?> type, Object oldInstance, Object newInstance, Encoder out)
          Produce a series of statements with side effects on newInstance so that the new instance becomes equivalent to oldInstance.
protected  Expression instantiate(Object oldInstance, Encoder out)
          Returns an expression whose value is oldInstance.
Methods inherited from class java.beans.PersistenceDelegate
mutatesTo, writeObject
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail


public PainterUtil.RenderingHintsDelegate()
Method Detail


protected Expression instantiate(Object oldInstance,
                                 Encoder out)
Description copied from class: java.beans.PersistenceDelegate
Returns an expression whose value is oldInstance. This method is used to characterize the constructor or factory method that should be used to create the given object. For example, the instantiate method of the persistence delegate for the Field class could be defined as follows:
 Field f = (Field)oldInstance;
 return new Expression(f, f.getDeclaringClass(), "getField", new Object[]{f.getName()});
Note that we declare the value of the returned expression so that the value of the expression (as returned by getValue) will be identical to oldInstance.

Specified by:
instantiate in class PersistenceDelegate
oldInstance - The instance that will be created by this expression.
out - The stream to which this expression will be written.
An expression whose value is oldInstance.


protected void initialize(Class<?> type,
                          Object oldInstance,
                          Object newInstance,
                          Encoder out)
Description copied from class: java.beans.PersistenceDelegate
Produce a series of statements with side effects on newInstance so that the new instance becomes equivalent to oldInstance. In the specification of this method, we mean by equivalent that, after the method returns, the modified instance is indistinguishable from newInstance in the behavior of all methods in its public API.

The implementation typically achieves this goal by producing a series of "what happened" statements involving the oldInstance and its publicly available state. These statements are sent to the output stream using its writeExpression method which returns an expression involving elements in a cloned environment simulating the state of an input stream during reading. Each statement returned will have had all instances the old environment replaced with objects which exist in the new one. In particular, references to the target of these statements, which start out as references to oldInstance are returned as references to the newInstance instead. Executing these statements effects an incremental alignment of the state of the two objects as a series of modifications to the objects in the new environment. By the time the initialize method returns it should be impossible to tell the two instances apart by using their public APIs. Most importantly, the sequence of steps that were used to make these objects appear equivalent will have been recorded by the output stream and will form the actual output when the stream is flushed.

The default implementation, calls the initialize method of the type's superclass.

initialize in class PersistenceDelegate
oldInstance - The instance to be copied.
newInstance - The instance that is to be modified.
out - The stream to which any initialization statements should be written.