ACE_Reactor_Token_T< ACE_TOKEN_TYPE > Class Template Reference

Used as a synchronization mechanism to coordinate concurrent access to an ACE_Reactor_Impl object. More...

#include <Reactor_Token_T.h>

Collaboration diagram for ACE_Reactor_Token_T< ACE_TOKEN_TYPE >:

Collaboration graph
[legend]

List of all members.

Public Member Functions

 ACE_Reactor_Token_T (ACE_Reactor_Impl &r, int s_queue=ACE_TOKEN_TYPE::FIFO)
 ACE_Reactor_Token_T (int s_queue=ACE_TOKEN_TYPE::FIFO)
virtual ~ACE_Reactor_Token_T (void)
virtual void sleep_hook (void)
ACE_Reactor_Implreactor (void)
 Get the reactor implementation.
void reactor (ACE_Reactor_Impl &)
 Set the reactor implementation.
virtual void dump (void) const
 Dump the state of an object.

Public Attributes

 ACE_ALLOC_HOOK_DECLARE
 Declare the dynamic allocation hooks.

Private Attributes

ACE_Reactor_Implreactor_


Detailed Description

template<class ACE_TOKEN_TYPE>
class ACE_Reactor_Token_T< ACE_TOKEN_TYPE >

Used as a synchronization mechanism to coordinate concurrent access to an ACE_Reactor_Impl object.

For internal use only.

For ACE internal use only.

This class is used to make access to a reactor's internals and demultiplexing mechanism thread-safe. By default, the thread that runs the handle_events() loop holds the token, even when it is blocked in the demultiplexer. Whenever another thread wants to access the reactor, such as via the register_handler(), remove_handler(), etc. methods, it must ask the token owner for temporary release of the token. To accomplish this, this class reimplements the ACE_Token::sleep_hook() method through which the owning thread can be notified to temporarily release the token if the current situation permits.

The owner of the token is responsible for deciding which request for the token can be granted. By using the ACE_Token::renew() method, the thread that releases the token temporarily can specify to get the token back right after the other thread has completed using the token. Thus, there is a dedicated thread that owns the token by default. This thread grants other threads access to the token by ensuring that whenever somebody else has finished using the token the original owner reclaims the token again, i.e., the owner has the chance to schedule other threads. The thread that most likely needs the token most of the time is the thread running the dispatch loop.


Constructor & Destructor Documentation

template<class ACE_TOKEN_TYPE>
ACE_Reactor_Token_T< ACE_TOKEN_TYPE >::ACE_Reactor_Token_T ( ACE_Reactor_Impl r,
int  s_queue = ACE_TOKEN_TYPE::FIFO 
) [inline]

template<class ACE_TOKEN_TYPE>
ACE_Reactor_Token_T< ACE_TOKEN_TYPE >::ACE_Reactor_Token_T ( int  s_queue = ACE_TOKEN_TYPE::FIFO  )  [inline]

template<class ACE_TOKEN_TYPE>
ACE_Reactor_Token_T< ACE_TOKEN_TYPE >::~ACE_Reactor_Token_T ( void   )  [inline, virtual]


Member Function Documentation

template<class ACE_TOKEN_TYPE>
void ACE_Reactor_Token_T< ACE_TOKEN_TYPE >::sleep_hook ( void   )  [inline, virtual]

Called just before a token waiter goes to sleep.

See also:
ACE_Token::sleep_hook

template<class ACE_TOKEN_TYPE>
ACE_Reactor_Impl & ACE_Reactor_Token_T< ACE_TOKEN_TYPE >::reactor ( void   )  [inline]

Get the reactor implementation.

template<class ACE_TOKEN_TYPE>
void ACE_Reactor_Token_T< ACE_TOKEN_TYPE >::reactor ( ACE_Reactor_Impl reactor  )  [inline]

Set the reactor implementation.

template<class ACE_TOKEN_TYPE>
ACE_BEGIN_VERSIONED_NAMESPACE_DECL void ACE_Reactor_Token_T< ACE_TOKEN_TYPE >::dump ( void   )  const [inline, virtual]

Dump the state of an object.


Member Data Documentation

template<class ACE_TOKEN_TYPE>
ACE_Reactor_Token_T< ACE_TOKEN_TYPE >::ACE_ALLOC_HOOK_DECLARE

Declare the dynamic allocation hooks.

template<class ACE_TOKEN_TYPE>
ACE_Reactor_Impl* ACE_Reactor_Token_T< ACE_TOKEN_TYPE >::reactor_ [private]


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

Generated on Wed Apr 23 02:40:53 2008 for ACE by  doxygen 1.5.5