TAO_PSDL_Datastore Class Reference

This class facilitates implementation of Persistent Service. Helps perform the bind and find to the hash_map. More...

#include <PSDL_Datastore.h>

Collaboration diagram for TAO_PSDL_Datastore:

[legend]List of all members.

Public Types
typedef ACE_Hash_Map_With_Allocator< TAO_PSDL_String, TAO_PSDL_OctetSeq >	NAME_OBJ_REF_MAP
	Hash map used by Persistent Naming Context to keep its state.
typedef ACE_Hash_Map_Entry< TAO_PSDL_String, TAO_PSDL_OctetSeq >	NAME_OBJ_REF_ENTRY
typedef ACE_Allocator_Adapter< ACE_Malloc< ACE_MMAP_MEMORY_POOL, TAO_SYNCH_MUTEX > >	ALLOCATOR
	Allocator we will be using to make the Naming Service persistent.
Public Member Functions
	TAO_PSDL_Datastore ()
	Constructor.
int	open (const ACE_TCHAR *file_name, void *base_address=ACE_DEFAULT_BASE_ADDR)
int	init (size_t context_size)
	~TAO_PSDL_Datastore (void)
int	bind (const char *name, const CORBA::OctetSeq &octetseq)
int	unbind (const char *name)
int	find (const char *name, CORBA::OctetSeq &octet_seq)
ACE_Allocator *	allocator (void)
	Return allocator.
Private Member Functions
int	recreate_all (void)
int	create_index (void)
	Helper for the <open> method.
int	create_index_helper (void *buffer)
Private Attributes
TAO_SYNCH_MUTEX	lock_
ALLOCATOR *	allocator_
NAME_OBJ_REF_MAP *	obj_ref_map_
	Hash map where we keep entries for all Persistent entries.
const ACE_TCHAR *	index_file_
	Name of the memory-mapped file used by <allocator_>.
void *	base_address_
	Base address for the memory-mapped file.

---

Detailed Description

This class facilitates implementation of Persistent Service. Helps perform the bind and find to the hash_map.

---

Member Typedef Documentation

typedef ACE_Hash_Map_With_Allocator<TAO_PSDL_String, TAO_PSDL_OctetSeq> TAO_PSDL_Datastore::NAME_OBJ_REF_MAP

Hash map used by Persistent Naming Context to keep its state.

typedef ACE_Hash_Map_Entry<TAO_PSDL_String, TAO_PSDL_OctetSeq> TAO_PSDL_Datastore::NAME_OBJ_REF_ENTRY

typedef ACE_Allocator_Adapter<ACE_Malloc <ACE_MMAP_MEMORY_POOL, TAO_SYNCH_MUTEX> > TAO_PSDL_Datastore::ALLOCATOR

Allocator we will be using to make the Naming Service persistent.

---

Constructor & Destructor Documentation

TAO_PSDL_Datastore::TAO_PSDL_Datastore

(

)

Constructor.

TAO_PSDL_Datastore::~TAO_PSDL_Datastore

(

void

)

Destructor. The memory mapped file that was opened/created is not deleted, since we want it to keep the state of the Database until the next run.

---

Member Function Documentation

int TAO_PSDL_Datastore::open	(	const ACE_TCHAR *	file_name,
		void *	base_address = ACE_DEFAULT_BASE_ADDR
	)

Create ACE_Allocator, open/create memory-mapped file with the specified file name/base address. Find or allocate <index_>. Return 0 on success or -1 on failure.

int TAO_PSDL_Datastore::init

(

size_t

context_size

)

If <index_> contains no entries (i.e., was just created), create a root Persistent servant with table of size <context_size>, and make an entry for it in the <index_>. If <index_> contains entries, create a Persistent servant for each entry. Return 0 on success and -1 on failure.

int TAO_PSDL_Datastore::bind	(	const char *	name,
		const CORBA::OctetSeq &	octetseq
	)

int TAO_PSDL_Datastore::unbind

(

const char *

name

)

int TAO_PSDL_Datastore::find	(	const char *	name,
		CORBA::OctetSeq &	octet_seq
	)

ACE_Allocator * TAO_PSDL_Datastore::allocator

(

void

)

Return allocator.

int TAO_PSDL_Datastore::recreate_all

(

void

)

[private]

Helper for the <init> method. Iterates over <index_>, and creates a servant for each entry.

int TAO_PSDL_Datastore::create_index

(

void

)

[private]

Helper for the <open> method.

int TAO_PSDL_Datastore::create_index_helper

(

void *

buffer

)

[private]

Helper for <create_index> method: places hash table into an allocated space.

---

Member Data Documentation

TAO_SYNCH_MUTEX TAO_PSDL_Datastore::lock_ [private]

Lock to prevent multiple threads from modifying entries in the <index_> simultanneously.

ALLOCATOR* TAO_PSDL_Datastore::allocator_ [private]

Allocator that deals out memory from a memory-mapped file. We use it whenever we deal with data that should be kept in persistent store.

NAME_OBJ_REF_MAP* TAO_PSDL_Datastore::obj_ref_map_ [private]

Hash map where we keep entries for all Persistent entries.

const ACE_TCHAR* TAO_PSDL_Datastore::index_file_ [private]

Name of the memory-mapped file used by <allocator_>.

void* TAO_PSDL_Datastore::base_address_ [private]

Base address for the memory-mapped file.

---

The documentation for this class was generated from the following files:

• PSDL_Datastore.h
• PSDL_Datastore.cpp

---