public Class Encoder

Returns a tentative value for oldInstance in the environment created by this stream. A persistence delegate can use its mutatesTo method to determine whether this value may be initialized to form the equivalent object at the output or whether a new object must be instantiated afresh. If the stream has not yet seen this value, null is returned.

Parameters

oldInstance:Object

The instance to be looked up.

Returns:Object

The object, null if the object has not been seen before.

Gets the exception handler for this stream.

Returns:ExceptionListener

The exception handler for this stream; Will return the default exception listener if this has not explicitly been set.

See Also

setExceptionListener

Returns the persistence delegate for the given type. The persistence delegate is calculated by applying the following rules in order:

1. If a persistence delegate is associated with the given type by using the setPersistenceDelegate method it is returned.
2. A persistence delegate is then looked up by the name composed of the fully qualified name of the given type and the "PersistenceDelegate" postfix. For example, a persistence delegate for the Bean class should be named BeanPersistenceDelegate and located in the same package.

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

   The instance of the BeanPersistenceDelegate class is returned for the Bean class.
3. If the type is null, a shared internal persistence delegate is returned that encodes null value.
4. If the type is an enum declaration, a shared internal persistence delegate is returned that encodes constants of this enumeration by their names.
5. If the type is a primitive type or the corresponding wrapper, a shared internal persistence delegate is returned that encodes values of the given type.
6. If the type is an array, a shared internal persistence delegate is returned that encodes an array of the appropriate type and length, and each of its elements as if they are properties.
7. If the type is a proxy, a shared internal persistence delegate is returned that encodes a proxy instance by using the java.lang.reflect.Proxy#newProxyInstance method.
8. If the BeanInfo for this type has a BeanDescriptor which defined a "persistenceDelegate" attribute, the value of this named attribute is returned.
9. In all other cases the default persistence delegate is returned. The default persistence delegate assumes the type is a JavaBean, implying that it has a default constructor and that its state may be characterized by the matching pairs of "setter" and "getter" methods returned by the Introspector class. The default constructor is the constructor with the greatest number of parameters that has the ConstructorProperties annotation. If none of the constructors has the ConstructorProperties annotation, then the nullary constructor (constructor with no parameters) will be used. For example, in the following code fragment, the nullary constructor for the Foo class will be used, while the two-parameter constructor for the Bar class will be used.

   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) { ... }
   }

Parameters

type:Class<?>

the class of the objects

Returns:PersistenceDelegate

the persistence delegate for the given type

See Also

setPersistenceDelegate, java.beans.Introspector#getBeanInfo, java.beans.BeanInfo#getBeanDescriptor

Removes the entry for this instance, returning the old entry.

Parameters

oldInstance:Object

The entry that should be removed.

Returns:Object

The entry that was removed.

See Also

get

Sets the exception handler for this stream to exceptionListener. The exception handler is notified when this stream catches recoverable exceptions.

Parameters

exceptionListener:ExceptionListener

The exception handler for this stream; if null the default exception listener will be used.

See Also

getExceptionListener

Associates the specified persistence delegate with the given type.

Parameters

type:Class<?>

the class of objects that the specified persistence delegate applies to

delegate:PersistenceDelegate

the persistence delegate for instances of the given type

See Also

getPersistenceDelegate, java.beans.Introspector#getBeanInfo, java.beans.BeanInfo#getBeanDescriptor

The implementation first checks to see if an expression with this value has already been written. If not, the expression is cloned, using the same procedure as writeStatement, and the value of this expression is reconciled with the value of the cloned expression by calling writeObject.

Parameters

oldExp:Expression

The expression to be written to the stream.

Writes statement oldStm to the stream. The oldStm should be written entirely in terms of the callers environment, i.e. the target and all arguments should be part of the object graph being written. These expressions represent a series of "what happened" expressions which tell the output stream how to produce an object graph like the original.

The implementation of this method will produce a second expression to represent the same expression in an environment that will exist when the stream is read. This is achieved simply by calling writeObject on the target and all the arguments and building a new expression with the results.

Parameters

oldStm:Statement

The expression to be written to the stream.