diff options
Diffstat (limited to 'TAO/orbsvcs/orbsvcs/Event/EC_Priority_Dispatching.h')
-rw-r--r-- | TAO/orbsvcs/orbsvcs/Event/EC_Priority_Dispatching.h | 90 |
1 files changed, 90 insertions, 0 deletions
diff --git a/TAO/orbsvcs/orbsvcs/Event/EC_Priority_Dispatching.h b/TAO/orbsvcs/orbsvcs/Event/EC_Priority_Dispatching.h new file mode 100644 index 00000000000..ebbb6cd6085 --- /dev/null +++ b/TAO/orbsvcs/orbsvcs/Event/EC_Priority_Dispatching.h @@ -0,0 +1,90 @@ +// -*- C++ -*- + +/** + * @file EC_Priority_Dispatching.h + * + * $Id$ + * + * @author Carlos O'Ryan (coryan@cs.wustl.edu) + * + * Based on previous work by Tim Harrison (harrison@cs.wustl.edu) and + * other members of the DOC group. More details can be found in: + * + * http://doc.ece.uci.edu/~coryan/EC/index.html + */ + +#ifndef TAO_EC_PRIORITY_DISPATCHING_H +#define TAO_EC_PRIORITY_DISPATCHING_H +#include /**/ "ace/pre.h" + +#include "orbsvcs/Event/EC_Dispatching.h" + +#if !defined (ACE_LACKS_PRAGMA_ONCE) +# pragma once +#endif /* ACE_LACKS_PRAGMA_ONCE */ + +#include "orbsvcs/RtecSchedulerC.h" +#include "orbsvcs/Event/sched_event_export.h" + +#include "ace/Thread_Manager.h" + +TAO_BEGIN_VERSIONED_NAMESPACE_DECL + +class TAO_EC_Dispatching_Task; +class TAO_EC_Event_Channel_Base; + +/** + * @class TAO_EC_Priority_Dispatching + * + * @brief Dispatching strategy that minimizes priority inversion. + * + * This strategy uses multiple queues, each serviced by a thread + * at different priority. This minimizes priority inversion + * because the consumers at higher priority are serviced before + * consumers at lower priority. + * It is more flexible than using the supplier thread to dispatch + * because it allows high-priority suppliers to push events to + * low-priority consumers (and vice-versa). + * It also isolates the supplier threads from the time spent on + * upcalls to the consumer objects, making the system easier to + * analyze and schedule. + */ +class TAO_RTSchedEvent_Export TAO_EC_Priority_Dispatching : public TAO_EC_Dispatching +{ +public: + /// The scheduler is used to find the range of priorities and similar + /// info. + TAO_EC_Priority_Dispatching (TAO_EC_Event_Channel_Base* ec); + + // = The EC_Dispatching methods. + virtual void activate (void); + virtual void shutdown (void); + virtual void push (TAO_EC_ProxyPushSupplier* proxy, + RtecEventComm::PushConsumer_ptr consumer, + const RtecEventComm::EventSet& event, + TAO_EC_QOS_Info& qos_info + ACE_ENV_ARG_DECL); + virtual void push_nocopy (TAO_EC_ProxyPushSupplier* proxy, + RtecEventComm::PushConsumer_ptr consumer, + RtecEventComm::EventSet& event, + TAO_EC_QOS_Info& qos_info + ACE_ENV_ARG_DECL); + +private: + /// Use our own thread manager. + ACE_Thread_Manager thread_manager_; + + /// The number of active tasks + int ntasks_; + + /// The tasks.. + TAO_EC_Dispatching_Task** tasks_; + + /// The scheduler + RtecScheduler::Scheduler_var scheduler_; +}; + +TAO_END_VERSIONED_NAMESPACE_DECL + +#include /**/ "ace/post.h" +#endif /* TAO_EC_PRIORITY_DISPATCHING_H */ |