diff options
Diffstat (limited to 'ACE/TAO/orbsvcs/orbsvcs/CosEvent/CEC_Dispatching.h')
-rw-r--r-- | ACE/TAO/orbsvcs/orbsvcs/CosEvent/CEC_Dispatching.h | 111 |
1 files changed, 111 insertions, 0 deletions
diff --git a/ACE/TAO/orbsvcs/orbsvcs/CosEvent/CEC_Dispatching.h b/ACE/TAO/orbsvcs/orbsvcs/CosEvent/CEC_Dispatching.h new file mode 100644 index 00000000000..02086605a55 --- /dev/null +++ b/ACE/TAO/orbsvcs/orbsvcs/CosEvent/CEC_Dispatching.h @@ -0,0 +1,111 @@ +// -*- C++ -*- + +//============================================================================= +/** + * @file CEC_Dispatching.h + * + * $Id$ + * + * @author Carlos O'Ryan (coryan@cs.wustl.edu) + */ +//============================================================================= + + +#ifndef TAO_CEC_DISPATCHING_H +#define TAO_CEC_DISPATCHING_H + +#include /**/ "ace/pre.h" + +#include "orbsvcs/CosEventCommC.h" + +#include "orbsvcs/CosEvent/event_serv_export.h" + +#if !defined (ACE_LACKS_PRAGMA_ONCE) +# pragma once +#endif /* ACE_LACKS_PRAGMA_ONCE */ + +TAO_BEGIN_VERSIONED_NAMESPACE_DECL + +class TAO_CEC_ProxyPushSupplier; +#if defined (TAO_HAS_TYPED_EVENT_CHANNEL) +class TAO_CEC_TypedEvent; +#endif /* TAO_HAS_TYPED_EVENT_CHANNEL */ + +/** + * @class TAO_CEC_Dispatching + * + * @brief Define the interface for the dispatching strategies. + * + * The EC may be configured with different dispatching strategies, + * for instance, it can use a pool of threads to dispatch the + * events, or a set of queues with threads at different priorities + * for each queue or can simply push the event to the consumer in + * FIFO order. + */ +class TAO_Event_Serv_Export TAO_CEC_Dispatching +{ +public: + /// destructor... + virtual ~TAO_CEC_Dispatching (void); + + /// Initialize all the data structures, activate any internal threads, + /// etc. + virtual void activate (void) = 0; + + /** + * Deactivate any internal threads and cleanup internal data + * structures, it should only return once the threads have finished + * their jobs. + */ + virtual void shutdown (void) = 0; + + /// The consumer represented by <proxy> should receive <event>. + virtual void push (TAO_CEC_ProxyPushSupplier *proxy, + const CORBA::Any &event) = 0; + virtual void push_nocopy (TAO_CEC_ProxyPushSupplier *proxy, + CORBA::Any &event) = 0; +#if defined (TAO_HAS_TYPED_EVENT_CHANNEL) + virtual void invoke (TAO_CEC_ProxyPushSupplier *proxy, + const TAO_CEC_TypedEvent &typed_event) = 0; + virtual void invoke_nocopy (TAO_CEC_ProxyPushSupplier *proxy, + TAO_CEC_TypedEvent &typed_event) = 0; +#endif /* TAO_HAS_TYPED_EVENT_CHANNEL */ +}; + +// **************************************************************** + +/** + * @class TAO_CEC_Reactive_Dispatching + * + * @brief Dispatch using the caller thread. + * + * The events are dispatched in FIFO ordering, using the invoking + * thread to push the event to the consumer. + */ +class TAO_Event_Serv_Export TAO_CEC_Reactive_Dispatching : public TAO_CEC_Dispatching +{ +public: + /// The scheduler is used to find the range of priorities and similar + /// info. + TAO_CEC_Reactive_Dispatching (void); + + // = The CEC_Dispatching methods. + virtual void activate (void); + virtual void shutdown (void); + virtual void push (TAO_CEC_ProxyPushSupplier *proxy, + const CORBA::Any &event); + virtual void push_nocopy (TAO_CEC_ProxyPushSupplier *proxy, + CORBA::Any &event); +#if defined (TAO_HAS_TYPED_EVENT_CHANNEL) + virtual void invoke (TAO_CEC_ProxyPushSupplier *proxy, + const TAO_CEC_TypedEvent &typed_event); + virtual void invoke_nocopy (TAO_CEC_ProxyPushSupplier *proxy, + TAO_CEC_TypedEvent &typed_event); +#endif /* TAO_HAS_TYPED_EVENT_CHANNEL */ +}; + +TAO_END_VERSIONED_NAMESPACE_DECL + +#include /**/ "ace/post.h" + +#endif /* TAO_CEC_DISPATCHING_H */ |