com.sun.faces.spi
Interface SerializationProvider


public interface SerializationProvider

This interface provides a mechanism to allow the use of alternate Java Serialization implementations.

The implementation of this interface *must* be thread-safe and must have a no-arg constructor.


Method Summary
 java.io.ObjectInputStream createObjectInputStream(java.io.InputStream source)
          Creates a new ObjectInputStream wrapping the specified source.
 java.io.ObjectOutputStream createObjectOutputStream(java.io.OutputStream destination)
          Creates a new ObjectOutputStream wrapping the specified destination.
 

Method Detail

createObjectInputStream

java.io.ObjectInputStream createObjectInputStream(java.io.InputStream source)
                                                  throws java.io.IOException

Creates a new ObjectInputStream wrapping the specified source.

It's extremely important that the ObjectInputStream returned by this method extends the serialization implementation's ObjectInputStream and overrides the ObjectInputStream.resolveClass(java.io.ObjectStreamClass) of to perform the following or the equivalent thereof:

     return Class.forName(desc.getName(),true, 
                Thread.currentThread().getContextClassLoader());
 

If this step isn't done, there may be problems when deserializing.

Parameters:
source - the source stream from which to read the Object(s) from
Returns:
an ObjectInputStream
Throws:
java.io.IOException

createObjectOutputStream

java.io.ObjectOutputStream createObjectOutputStream(java.io.OutputStream destination)
                                                    throws java.io.IOException

Creates a new ObjectOutputStream wrapping the specified destination.

Parameters:
destination - the destination of the serialized Object(s)
Returns:
an ObjectOutputStream
Throws:
java.io.IOException


Copyright ? 2002-2006 Sun Microsystems, Inc. All Rights Reserved.