apache::geode::client::PersistenceManager Class Reference

PersistenceManager API for persistence and overflow. More...

Inherits apache::geode::client::SharedBase.

Public Member Functions
virtual void	close ()=0
	Closes the persistence manager instance. More...
virtual void	destroy (const CacheableKeyPtr &key, void *&PersistenceInfo)=0
	destroys the entry specified by the key in the argument. More...
virtual void	init (const RegionPtr &region, PropertiesPtr &diskProperties)=0
	This method gets called after an implementation object is created. More...
void	preserveSB () const
	Atomically increment reference count. More...
virtual CacheablePtr	read (const CacheableKeyPtr &key, void *&PersistenceInfo)=0
	Reads the value for the key from the disk. More...
virtual bool	readAll ()=0
	Reads all the values from the region. More...
int32_t	refCount ()
void	releaseSB () const
	Atomically decrement reference count, the SharedBase object is automatically deleted when its reference count goes to zero. More...
virtual void	write (const CacheableKeyPtr &key, const CacheablePtr &value, void *&PersistenceInfo)=0
	Writes a key, value pair of region to the disk. More...
virtual bool	writeAll ()=0
	Writes all the entries for a region. More...
virtual	~PersistenceManager ()=0
	destructor More...

Static Public Member Functions
static PersistenceManagerPtr	getPersistenceManager ()
	public methods More...

Protected Attributes
const RegionPtr	m_regionPtr
	Region for this persistence manager. More...

Detailed Description

PersistenceManager API for persistence and overflow.

This class abstracts the disk-related operations in case of persistence or overflow to disk. A specific disk storage implementation will implement all the methods described here.

Constructor & Destructor Documentation

virtual apache::geode::client::PersistenceManager::~PersistenceManager ( )

pure virtual

destructor

Member Function Documentation

virtual void apache::geode::client::PersistenceManager::close ( )

pure virtual

Closes the persistence manager instance.

Exceptions

ShutdownFailedException

if close is not successful.

virtual void apache::geode::client::PersistenceManager::destroy ( const CacheableKeyPtr &  key, void *&  PersistenceInfo  )

pure virtual

destroys the entry specified by the key in the argument.

Parameters

key	is the key of the entry which is being destroyed.
PersistenceInfo	related persistence information.

Exceptions

RegionDestroyedException	is the region is already destroyed.
EntryNotFoundException	if the entry is not found on the disk.

static PersistenceManagerPtr apache::geode::client::PersistenceManager::getPersistenceManager ( )

static

public methods

Returns the current persistence manager.

Returns

persistence manager

virtual void apache::geode::client::PersistenceManager::init ( const RegionPtr &  region, PropertiesPtr &  diskProperties  )

pure virtual

This method gets called after an implementation object is created.

Initializes all the implementation specific environments needed.

Exceptions

InitfailedException

if the persistence manager cannot be initialized.

void apache::geode::client::SharedBase::preserveSB ( ) const

inherited

Atomically increment reference count.

virtual CacheablePtr apache::geode::client::PersistenceManager::read ( const CacheableKeyPtr &  key, void *&  PersistenceInfo  )

pure virtual

Reads the value for the key from the disk.

Parameters

key	is the key for which the value has to be read.
PersistenceInfo	related persistence information.

Returns

value of type CacheablePtr.

Exceptions

DiskCorruptException

if the data to be read is corrupt.

virtual bool apache::geode::client::PersistenceManager::readAll ( )

pure virtual

Reads all the values from the region.

Returns

true

int32_t apache::geode::client::SharedBase::refCount ( )

inlineinherited

Returns

the reference count

void apache::geode::client::SharedBase::releaseSB ( ) const

inherited

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

virtual void apache::geode::client::PersistenceManager::write ( const CacheableKeyPtr &  key, const CacheablePtr &  value, void *&  PersistenceInfo  )

pure virtual

Writes a key, value pair of region to the disk.

The actual file or database related write operations should be implemented in this method by the class implementing this method.

Parameters

key	the key to write.
value	the value to write
PersistenceInfo	related persistence information.

Exceptions

RegionDestroyedException	is the region is already destroyed.
OutofMemoryException	if the disk is full
DiskFailureException	if the write fails due to disk fail.

virtual bool apache::geode::client::PersistenceManager::writeAll ( )

pure virtual

Writes all the entries for a region.

Refer persistance requirement doc for the use case.

Exceptions

DiskFailureException

if the write fails due to disk fail.

Field Documentation

const RegionPtr apache::geode::client::PersistenceManager::m_regionPtr

protected

Region for this persistence manager.