gemfire::Serializable Class Reference

Inherits gemfire::SharedBase.

Inherited by gemfire::CacheableArrayType< TObj, TYPEID >, gemfire::CacheableContainerType< TBase, TYPEID >, gemfire::CacheableKey, gemfire::CacheableObjectArray, gemfire::CacheableUndefined, gemfire::Properties, gemfire::RegionAttributes, gemfire::Struct, and gemfire::UserFunctionExecutionException.


Detailed Description

This abstract base class is the superclass of all user objects in the cache that can be serialized.

Public Member Functions

virtual int32_t classId () const =0
virtual int8_t DSFID () const
virtual SerializablefromData (DataInput &input)=0
virtual uint32_t objectSize () const
void preserveSB () const
 Atomically increment reference count.
int32_t refCount ()
 
Returns:
the reference count

void releaseSB () const
 Atomically decrement reference count, the SharedBase object is automatically deleted when its reference count goes to zero.
virtual void toData (DataOutput &output) const =0
virtual
CacheableStringPtr 
toString () const
 Display this object as 'string', which depends on the implementation in the subclasses.
virtual int8_t typeId () const
virtual ~Serializable ()

Static Public Member Functions

template<class PRIM>
static SerializablePtr create (const PRIM value)
 Factory method that creates the Serializable object that matches the type of value.
static void registerPdxSerializer (PdxSerializerPtr pdxSerializer)
 Register the PDX serializer which can handle serialization for instances of user domain classes.
static void registerPdxType (TypeFactoryMethodPdx creationFunction)
static void registerType (TypeFactoryMethod creationFunction)

Protected Member Functions

 Serializable ()

Constructor & Destructor Documentation

virtual gemfire::Serializable::~Serializable (  )  [inline, virtual]

destructor

gemfire::Serializable::Serializable (  )  [inline, protected]

constructors


Member Function Documentation

virtual int32_t gemfire::Serializable::classId (  )  const [pure virtual]

Return the classId of the instance being serialized. This is used by deserialization to determine what instance type to create and deserialize into.

The classId must be unique within an application suite. Using a negative value may result in undefined behavior.

Implemented in gemfire::CacheableKeyType< TObj, TYPEID, TYPENAME, SPRINTFSYM, STRSIZE >, gemfire::CacheableArrayType< TObj, TYPEID >, gemfire::CacheableContainerType< TBase, TYPEID >, gemfire::CacheableDate, gemfire::CacheableEnum, gemfire::CacheableFileName, gemfire::CacheableObjectArray, gemfire::CacheableString, gemfire::CacheableUndefined, gemfire::Properties, gemfire::RegionAttributes, gemfire::Struct, and gemfire::UserFunctionExecutionException.

template<class PRIM>
static SerializablePtr gemfire::Serializable::create ( const PRIM  value  )  [inline, static]

Factory method that creates the Serializable object that matches the type of value.

For customer defined derivations of Serializable, the method gemfire::createValue may be overloaded. For pointer types (e.g. char*) the method gemfire::createValueArr may be overloaded.

Reimplemented in gemfire::CacheableKey.

virtual int8_t gemfire::Serializable::DSFID (  )  const [virtual]

return the Data Serialization Fixed ID type. This is used to determine what instance type to create and deserialize into.

Note that this should not be overridden by custom implementations and is reserved only for builtin types.

Reimplemented in gemfire::CacheableUndefined, and gemfire::Struct.

virtual Serializable* gemfire::Serializable::fromData ( DataInput input  )  [pure virtual]

deserialize this object, typical implementation should return the 'this' pointer.

Implemented in gemfire::CacheableKeyType< TObj, TYPEID, TYPENAME, SPRINTFSYM, STRSIZE >, gemfire::CacheableArrayType< TObj, TYPEID >, gemfire::CacheableContainerType< TBase, TYPEID >, gemfire::CacheableDate, gemfire::CacheableEnum, gemfire::CacheableFileName, gemfire::CacheableObjectArray, gemfire::CacheableString, gemfire::CacheableUndefined, gemfire::Properties, gemfire::RegionAttributes, gemfire::Struct, and gemfire::UserFunctionExecutionException.

virtual uint32_t gemfire::Serializable::objectSize (  )  const [virtual]

return the size in bytes of the instance being serialized. This is used to determine whether the cache is using up more physical memory than it has been configured to use. The method can return zero if the user does not require the ability to control cache memory utilization. Note that you must implement this only if you use the HeapLRU feature.

Reimplemented in gemfire::CacheableKeyType< TObj, TYPEID, TYPENAME, SPRINTFSYM, STRSIZE >, gemfire::CacheableArrayType< TObj, TYPEID >, gemfire::CacheableContainerType< TBase, TYPEID >, gemfire::CacheableDate, gemfire::CacheableEnum, gemfire::CacheableObjectArray, gemfire::CacheableString, gemfire::CacheableUndefined, gemfire::Properties, gemfire::RegionAttributes, gemfire::Struct, and gemfire::UserFunctionExecutionException.

void gemfire::SharedBase::preserveSB (  )  const [inherited]

Atomically increment reference count.

int32_t gemfire::SharedBase::refCount (  )  [inline, inherited]

Returns:
the reference count

static void gemfire::Serializable::registerPdxSerializer ( PdxSerializerPtr  pdxSerializer  )  [static]

Register the PDX serializer which can handle serialization for instances of user domain classes.

See also:
PdxSerializer

static void gemfire::Serializable::registerPdxType ( TypeFactoryMethodPdx  creationFunction  )  [static]

register an Pdx instance factory method for a given type.

Exceptions:
IllegalStateException if the typeName has already been registered, or there is an error in registering the type; check errno for more information in the latter case.

static void gemfire::Serializable::registerType ( TypeFactoryMethod  creationFunction  )  [static]

register an instance factory method for a given type. During registration the factory will be invoked to extract the typeId to associate with this function.

Exceptions:
IllegalStateException if the typeId has already been registered, or there is an error in registering the type; check errno for more information in the latter case.

void gemfire::SharedBase::releaseSB (  )  const [inherited]

Atomically decrement reference count, the SharedBase object is automatically deleted when its reference count goes to zero.

virtual void gemfire::Serializable::toData ( DataOutput output  )  const [pure virtual]

serialize this object

Implemented in gemfire::CacheableKeyType< TObj, TYPEID, TYPENAME, SPRINTFSYM, STRSIZE >, gemfire::CacheableArrayType< TObj, TYPEID >, gemfire::CacheableContainerType< TBase, TYPEID >, gemfire::CacheableDate, gemfire::CacheableEnum, gemfire::CacheableFileName, gemfire::CacheableObjectArray, gemfire::CacheableString, gemfire::CacheableUndefined, gemfire::Properties, gemfire::RegionAttributes, gemfire::Struct, and gemfire::UserFunctionExecutionException.

virtual CacheableStringPtr gemfire::Serializable::toString (  )  const [virtual]

Display this object as 'string', which depends on the implementation in the subclasses.

The default implementation renders the classname.

The return value may be a temporary, so the caller has to ensure that the SharedPtr count does not go down to zero by storing the result in a variable or otherwise.

Reimplemented in gemfire::CacheableKeyType< TObj, TYPEID, TYPENAME, SPRINTFSYM, STRSIZE >, gemfire::CacheableDate, gemfire::CacheableEnum, and gemfire::CacheableString.

virtual int8_t gemfire::Serializable::typeId (  )  const [virtual]

return the typeId byte of the instance being serialized. This is used by deserialization to determine what instance type to create and deserialize into.

Note that this should not be overridden by custom implementations and is reserved only for builtin types.

Reimplemented in gemfire::CacheableKeyType< TObj, TYPEID, TYPENAME, SPRINTFSYM, STRSIZE >, gemfire::CacheableArrayType< TObj, TYPEID >, gemfire::CacheableContainerType< TBase, TYPEID >, gemfire::CacheableDate, gemfire::CacheableEnum, gemfire::CacheableFileName, gemfire::CacheableObjectArray, gemfire::CacheableString, gemfire::CacheableUndefined, gemfire::Properties, gemfire::RegionAttributes, gemfire::Struct, and gemfire::UserFunctionExecutionException.


GemFire C++ Cache API Documentation