diff options
Diffstat (limited to 'ace/FlReactor.h')
-rw-r--r-- | ace/FlReactor.h | 78 |
1 files changed, 37 insertions, 41 deletions
diff --git a/ace/FlReactor.h b/ace/FlReactor.h index f13a731c978..20d2ad5e34d 100644 --- a/ace/FlReactor.h +++ b/ace/FlReactor.h @@ -1,24 +1,19 @@ /* -*- C++ -*- */ -// $Id$ - -// ============================================================================ -// -// = LIBRARY -// ace -// -// = FILENAME -// FlReactor.h -// -// = AUTHOR -// Carlos O'Ryan <coryan@cs.wustl.edu> -// -// Based in part in the ACE_XtReactor implementation by: -// -// Eric C. Newton's <ecn@clark.net>, -// Kirill Rybaltchenko <Kirill.Rybaltchenko@cern.ch>, and -// Douglas C. Schmidt <schmidt@cs.wustl.edu> -// -// ============================================================================ + +//============================================================================= +/** + * @file FlReactor.h + * + * $Id$ + * + * @author Carlos O'Ryan <coryan@cs.wustl.edu> + * @author Based in part in the ACE_XtReactor implementation by + * @author Eric C. Newton's <ecn@clark.net> + * @author Kirill Rybaltchenko <Kirill.Rybaltchenko@cern.ch> + * @author Douglas C. Schmidt <schmidt@cs.wustl.edu> + */ +//============================================================================= + #ifndef ACE_FLREACTOR_H #define ACE_FLREACTOR_H @@ -32,20 +27,21 @@ #if defined (ACE_HAS_FL) +/** + * @class ACE_FlReactor + * + * @brief A Reactor implementation that uses the Fast-Light (FL) toolkit + * for event demultiplexing. This will let us integrate the FL + * toolkit with ACE and/or TAO. + * + * As many other GUI toolkits FL supports a minimal set of + * callbacks to handle event demultiplexing, namely simple methods + * to add file descriptors to the event demuxing set or timeout + * events. This class adapts this simple mechanisms so they are + * compatible with ACE's Reactor. + */ class ACE_Export ACE_FlReactor : public ACE_Select_Reactor { - // = TITLE - // A Reactor implementation that uses the Fast-Light (FL) toolkit - // for event demultiplexing. This will let us integrate the FL - // toolkit with ACE and/or TAO. - // - // = DESCRIPTION - // As many other GUI toolkits FL supports a minimal set of - // callbacks to handle event demultiplexing, namely simple methods - // to add file descriptors to the event demuxing set or timeout - // events. This class adapts this simple mechanisms so they are - // compatible with ACE's Reactor. - // public: // = Initialization and termination methods. @@ -59,7 +55,7 @@ public: const void *arg, const ACE_Time_Value &delta_time, const ACE_Time_Value &interval); - virtual int reset_timer_interval (long timer_id, + virtual int reset_timer_interval (long timer_id, const ACE_Time_Value &interval); virtual int cancel_timer (ACE_Event_Handler *handler, int dont_call_handle_close = 1); @@ -69,40 +65,40 @@ public: protected: // = Register timers/handles with Fl. + /// Register a single <handler>. virtual int register_handler_i (ACE_HANDLE handle, ACE_Event_Handler *handler, ACE_Reactor_Mask mask); - // Register a single <handler>. + /// Register a set of <handlers>. virtual int register_handler_i (const ACE_Handle_Set &handles, ACE_Event_Handler *handler, ACE_Reactor_Mask mask); - // Register a set of <handlers>. + /// Remove the <handler> associated with this <handle>. virtual int remove_handler_i (ACE_HANDLE handle, ACE_Reactor_Mask mask); - // Remove the <handler> associated with this <handle>. + /// Remove a set of <handles>. virtual int remove_handler_i (const ACE_Handle_Set &handles, ACE_Reactor_Mask); - // Remove a set of <handles>. + /// Wait for events to occur. virtual int wait_for_multiple_events (ACE_Select_Reactor_Handle_Set &, ACE_Time_Value *); - // Wait for events to occur. private: + /// This method ensures there's an Fl timeout for the first timeout + /// in the Reactor's Timer_Queue. void reset_timeout (void); - // This method ensures there's an Fl timeout for the first timeout - // in the Reactor's Timer_Queue. // = Integrate with the FL callback function mechanism. static void fl_io_proc (int fd, void*); static void fl_timeout_proc (void*); + /// Deny access since member-wise won't work... ACE_FlReactor (const ACE_FlReactor &); ACE_FlReactor &operator = (const ACE_FlReactor &); - // Deny access since member-wise won't work... }; #if defined(__ACE_INLINE__) |