Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members  

TAO_ESF_Proxy_RefCount_Guard Class Template Reference

Reference count based guard. More...

#include <ESF_Proxy_RefCount_Guard.h>

List of all members.

Public Methods

 TAO_ESF_Proxy_RefCount_Guard (CORBA::ULong &refcount, EVENT_CHANNEL *ec, PROXY *proxy)
 Constructor.

 ~TAO_ESF_Proxy_RefCount_Guard (void)
 Destructor.


Protected Attributes

CORBA::ULong& refcount_
 The reference count, if it gets to zero then the object must be destroyed.

EVENT_CHANNEL* event_channel_
 The event channel used to destroy the proxy.

PROXY* proxy_
 The proxy whose lifetime is controlled by the reference count.


Detailed Description

template<class EVENT_CHANNEL, class PROXY> template class TAO_ESF_Proxy_RefCount_Guard

Reference count based guard.

A common idiom used on event services is to increment a reference count before starting a long running operation. The system can then execute the operation without any risk of having the underlying object destroyed. The advantage of using a reference count is that no mutex or lock needs to be held while the operation is beign executed. This class implements that common idiom, but it also adds hooks to handle scenarios where more than one operation is performed while holding the reference count.

@TODO: The type of lock could be parametric


Constructor & Destructor Documentation

template<classEC, classP>
ACE_INLINE TAO_ESF_Proxy_RefCount_Guard< EC,P >::TAO_ESF_Proxy_RefCount_Guard<EC, P> ( CORBA::ULong & refcount,
EC * ec,
P * proxy )
 

Constructor.

template<classEVENT_CHANNEL, classPROXY>
TAO_ESF_Proxy_RefCount_Guard<EVENT_CHANNEL, PROXY>::~TAO_ESF_Proxy_RefCount_Guard<EVENT_CHANNEL, PROXY> ( void )
 

Destructor.


Member Data Documentation

template<classEVENT_CHANNEL, classPROXY>
EVENT_CHANNEL * TAO_ESF_Proxy_RefCount_Guard<EVENT_CHANNEL, PROXY>::event_channel_ [protected]
 

The event channel used to destroy the proxy.

template<classEVENT_CHANNEL, classPROXY>
PROXY * TAO_ESF_Proxy_RefCount_Guard<EVENT_CHANNEL, PROXY>::proxy_ [protected]
 

The proxy whose lifetime is controlled by the reference count.

template<classEVENT_CHANNEL, classPROXY>
CORBA::ULong & TAO_ESF_Proxy_RefCount_Guard<EVENT_CHANNEL, PROXY>::refcount_ [protected]
 

The reference count, if it gets to zero then the object must be destroyed.


The documentation for this class was generated from the following files:
Generated at Sat Dec 1 12:25:34 2001 for TAO_ESF by doxygen1.2.3 written by Dimitri van Heesch, © 1997-2000