com.tangosol.io.pof
Class SimplePofContext

java.lang.Object
  com.tangosol.io.SimpleSerializer
      com.tangosol.io.pof.SimplePofContext

All Implemented Interfaces:

ClassLoaderAware, PofContext, Serializer

public class SimplePofContext
extends SimpleSerializer
implements PofContext

Basic PofContext implementation.

Since:

Coherence 3.2

Author:

jh 2006.07.18

See Also:

PortableObjectSerializer

Field Summary

protected LongArray	m_laClass A LongArray of user types, indexed by type identifier.
protected LongArray	m_laSerializer A LongArray of PofSerializer objects, indexed by type identifier.
protected Map	m_mapTypeId A Map that contains mappings from a registered user type into type identifier.

Constructor Summary

SimplePofContext()
Create a new SimplePofContext.

Method Summary

Object	deserialize(ReadBuffer.BufferInput in) Deserialize an object from a ReadBuffer by reading its state using the specified BufferInput object.
Class	getClass(int nTypeId) Determine the class associated with the given user type identifier.
String	getClassName(int nTypeId) Determine the name of the class associated with the given user type identifier.
PofSerializer	getPofSerializer(int nTypeId) Return a PofSerializer that can be used to serialize and deserialize an object of the specified user type to and from a POF stream.
int	getUserTypeIdentifier(Class clz) Determine the user type identifier associated with the given class.
int	getUserTypeIdentifier(Object o) Determine the user type identifier associated with the given object.
int	getUserTypeIdentifier(String sClass) Determine the user type identifier associated with the given class name.
boolean	isUserType(Class clz) Determine if the given class is a user type known to this PofContext.
boolean	isUserType(Object o) Determine if the given object is of a user type known to this PofContext.
boolean	isUserType(String sClass) Determine if the class with the given name is a user type known to this PofContext.
void	registerUserType(int nTypeId, Class clz, PofSerializer serializer) Associate a user type with a type identifier and PofSerializer.
void	serialize(WriteBuffer.BufferOutput out, Object o) Serialize an object to a WriteBuffer by writing its state using the specified BufferOutput object.
void	unregisterUserType(int nTypeId) Unregister a user type that was previously registered using the specified type identifier.
protected static void	validateTypeId(int nTypeId) Ensure that the given user type identifier is valid.

Methods inherited from class com.tangosol.io.SimpleSerializer

getContextClassLoader, setContextClassLoader

Methods inherited from interface com.tangosol.io.ClassLoaderAware

getContextClassLoader, setContextClassLoader

Field Detail

m_mapTypeId

protected Map m_mapTypeId

A Map that contains mappings from a registered user type into type identifier.

m_laClass

protected LongArray m_laClass

A LongArray of user types, indexed by type identifier.

m_laSerializer

protected LongArray m_laSerializer

A LongArray of PofSerializer objects, indexed by type identifier.

Constructor Detail

SimplePofContext

public SimplePofContext()

Create a new SimplePofContext.

Method Detail

serialize

public void serialize(WriteBuffer.BufferOutput out,
                      Object o)
               throws IOException

Serialize an object to a WriteBuffer by writing its state using the specified BufferOutput object.

Specified by:

serialize in interface Serializer

Overrides:

serialize in class SimpleSerializer

Parameters:

out - the BufferOutput with which to write the object's state

o - the object to serialize

Throws:

IOException - if an I/O error occurs

deserialize

public Object deserialize(ReadBuffer.BufferInput in)
                   throws IOException

Deserialize an object from a ReadBuffer by reading its state using the specified BufferInput object.

Specified by:

deserialize in interface Serializer

Overrides:

deserialize in class SimpleSerializer

Parameters:

in - the BufferInput with which to read the object's state

Returns:

the deserialized user type instance

Throws:

IOException - if an I/O error occurs

getPofSerializer

public PofSerializer getPofSerializer(int nTypeId)

Return a PofSerializer that can be used to serialize and deserialize an object of the specified user type to and from a POF stream.

Specified by:

getPofSerializer in interface PofContext

Parameters:

nTypeId - the type identifier of the user type that can be serialized and deserialized using the returned PofSerializer; must be non-negative

Returns:

a PofSerializer for the specified user type

getUserTypeIdentifier

public int getUserTypeIdentifier(Object o)

Determine the user type identifier associated with the given object.

Specified by:

getUserTypeIdentifier in interface PofContext

Parameters:

o - an instance of a user type; must not be null

Returns:

the type identifier of the user type associated with the given object

getUserTypeIdentifier

public int getUserTypeIdentifier(Class clz)

Determine the user type identifier associated with the given class.

Specified by:

getUserTypeIdentifier in interface PofContext

Parameters:

clz - a user type class; must not be null

Returns:

the type identifier of the user type associated with the given class

getUserTypeIdentifier

public int getUserTypeIdentifier(String sClass)

Determine the user type identifier associated with the given class name.

Specified by:

getUserTypeIdentifier in interface PofContext

Parameters:

sClass - the name of a user type class; must not be null

Returns:

the type identifier of the user type associated with the given class name

getClassName

public String getClassName(int nTypeId)

Determine the name of the class associated with the given user type identifier.

Specified by:

getClassName in interface PofContext

Parameters:

nTypeId - the user type identifier; must be non-negative

Returns:

the name of the class associated with the specified user type identifier

getClass

public Class getClass(int nTypeId)

Determine the class associated with the given user type identifier.

Specified by:

getClass in interface PofContext

Parameters:

nTypeId - the user type identifier; must be non-negative

Returns:

the class associated with the specified user type identifier

isUserType

public boolean isUserType(Object o)

Determine if the given object is of a user type known to this PofContext.

Specified by:

isUserType in interface PofContext

Parameters:

o - the object to test; must not be null

Returns:

true iff the specified object is of a valid user type

isUserType

public boolean isUserType(Class clz)

Determine if the given class is a user type known to this PofContext.

Specified by:

isUserType in interface PofContext

Parameters:

clz - the class to test; must not be null

Returns:

true iff the specified class is a valid user type

isUserType

public boolean isUserType(String sClass)

Determine if the class with the given name is a user type known to this PofContext.

Specified by:

isUserType in interface PofContext

Parameters:

sClass - the name of the class to test; must not be null

Returns:

true iff the class with the specified name is a valid user type

registerUserType

public void registerUserType(int nTypeId,
                             Class clz,
                             PofSerializer serializer)

Associate a user type with a type identifier and PofSerializer.

Parameters:

nTypeId - the type identifier of the specified user type; must be greater or equal to 0

clz - the user type to register with this PofContext; must not be null

serializer - the PofSerializer that will be used to serialize and deserialize objects of the specified class

Throws:

IllegalArgumentException - on invalid type identifer, class, or PofSerializer

unregisterUserType

public void unregisterUserType(int nTypeId)

Unregister a user type that was previously registered using the specified type identifier.

Parameters:

nTypeId - the type identifier of the user type to unregister

Throws:

IllegalArgumentException - if the specified user type identifier is unknown to this PofContext

validateTypeId

protected static void validateTypeId(int nTypeId)

Ensure that the given user type identifier is valid.

Parameters:

nTypeId - the user type identifier to validate

Throws:

IllegalArgumentException - if the given user type identifier is negative