NAME

ACE_ReactorEx_Notify - Unblock the ACE_ReactorEx from its event loop, passing it an optional ACE_Event_Handler to dispatch.

SYNOPSIS

#include <ace/ReactorEx.h>

class ACE_ReactorEx_Notify : public ACE_Event_Handler { public: ACE_ReactorEx_Notify (void); int open (ACE_ReactorEx &reactorEx, ACE_Timer_Queue *timer_queue); int notify ( ACE_Event_Handler *eh = 0, ACE_Reactor_Mask mask = ACE_Event_Handler::EXCEPT_MASK, ACE_Time_Value *timeout = 0 ); virtual ACE_HANDLE get_handle (void) const; void max_notify_iterations (int); int max_notify_iterations (void); private: ACE_Timer_Queue *timer_queue_; virtual int handle_signal ( int signum, siginfo_t * = 0, ucontext_t * = 0 ); ACE_Auto_Event wakeup_one_thread_; ACE_Message_Queue<ACE_MT_SYNCH> message_queue_; int max_notify_iterations_; };

DESCRIPTION

This implementation is necessary for cases where the ACE_ReactorEx is run in a multi-threaded program. In this case, we need to be able to unblock WaitForMultipleObjects() when updates occur other than in the main ACE_ReactorEx thread. To do this, we signal an auto-reset event the ACE_ReactorEx is listening on. If an ACE_Event_Handler and ACE_Reactor_Mask is passed to notify, the appropriate handle_* method is dispatched.

PUBLIC MEMBERS

ACE_ReactorEx_Notify (void);

int open (ACE_ReactorEx &reactorEx, ACE_Timer_Queue *timer_queue);

int notify (
    ACE_Event_Handler *eh = 0,
    ACE_Reactor_Mask mask = ACE_Event_Handler::EXCEPT_MASK,
    ACE_Time_Value *timeout = 0
    );

virtual ACE_HANDLE get_handle (void) const;

void max_notify_iterations (int);

int max_notify_iterations (void);

PRIVATE MEMBERS

ACE_Timer_Queue *timer_queue_;

virtual int handle_signal (
    int signum,
    siginfo_t * = 0,
    ucontext_t * = 0
    );

ACE_Auto_Event wakeup_one_thread_;

ACE_Message_Queue<ACE_MT_SYNCH> message_queue_;

int max_notify_iterations_;

AUTHOR

Irfan Pyarali, Tim Harrison, and Doug Schmidt

LIBRARY

ace