added ace + vcproj for win
--HG-- branch : trunk
This commit is contained in:
Vendored
+342
@@ -0,0 +1,342 @@
|
||||
/* -*- C++ -*- */
|
||||
|
||||
//=============================================================================
|
||||
/**
|
||||
* @file Timer_Hash_T.h
|
||||
*
|
||||
* $Id: Timer_Hash_T.h 80826 2008-03-04 14:51:23Z wotte $
|
||||
*
|
||||
* @author Darrell Brunsch <[email protected]>
|
||||
*/
|
||||
//=============================================================================
|
||||
|
||||
#ifndef ACE_TIMER_HASH_T_H
|
||||
#define ACE_TIMER_HASH_T_H
|
||||
#include /**/ "ace/pre.h"
|
||||
|
||||
#include "ace/Timer_Queue_T.h"
|
||||
|
||||
#if !defined (ACE_LACKS_PRAGMA_ONCE)
|
||||
# pragma once
|
||||
#endif /* ACE_LACKS_PRAGMA_ONCE */
|
||||
|
||||
#include "ace/Free_List.h"
|
||||
|
||||
ACE_BEGIN_VERSIONED_NAMESPACE_DECL
|
||||
|
||||
// Forward declaration.
|
||||
template <class TYPE, class FUNCTOR, class ACE_LOCK, class BUCKET>
|
||||
class ACE_Timer_Hash_T;
|
||||
template <typename TYPE>
|
||||
class Hash_Token;
|
||||
|
||||
/**
|
||||
* @class ACE_Timer_Hash_Upcall
|
||||
*
|
||||
* @brief Functor for Timer_Hash
|
||||
*
|
||||
* This class calls up to the Timer Hash's functor from the
|
||||
* timer queues in the hash table
|
||||
*/
|
||||
template <class TYPE, class FUNCTOR, class ACE_LOCK>
|
||||
class ACE_Timer_Hash_Upcall
|
||||
{
|
||||
public:
|
||||
typedef ACE_Timer_Queue_T<ACE_Event_Handler *,
|
||||
ACE_Timer_Hash_Upcall<TYPE, FUNCTOR, ACE_LOCK>,
|
||||
ACE_Null_Mutex>
|
||||
TIMER_QUEUE;
|
||||
|
||||
/// Default constructor (creates an invalid object, but needs to be here
|
||||
/// so timer queues using this functor can be constructed)
|
||||
ACE_Timer_Hash_Upcall (void);
|
||||
|
||||
/// Constructor that specifies a Timer_Hash to call up to
|
||||
ACE_Timer_Hash_Upcall (ACE_Timer_Queue_T<TYPE, FUNCTOR, ACE_LOCK> *timer_hash);
|
||||
|
||||
/// This method is called when a timer is registered.
|
||||
int registration (TIMER_QUEUE &timer_queue,
|
||||
ACE_Event_Handler *handler,
|
||||
const void *arg);
|
||||
|
||||
/// This method is called before the timer expires.
|
||||
int preinvoke (TIMER_QUEUE &timer_queue,
|
||||
ACE_Event_Handler *handler,
|
||||
const void *arg,
|
||||
int recurring_timer,
|
||||
const ACE_Time_Value &cur_time,
|
||||
const void *&upcall_act);
|
||||
|
||||
/// This method is called when the timer expires.
|
||||
int timeout (TIMER_QUEUE &timer_queue,
|
||||
ACE_Event_Handler *handler,
|
||||
const void *arg,
|
||||
int recurring_timer,
|
||||
const ACE_Time_Value &cur_time);
|
||||
|
||||
/// This method is called after the timer expires.
|
||||
int postinvoke (TIMER_QUEUE &timer_queue,
|
||||
ACE_Event_Handler *handler,
|
||||
const void *arg,
|
||||
int recurring_timer,
|
||||
const ACE_Time_Value &cur_time,
|
||||
const void *upcall_act);
|
||||
|
||||
/// This method is called when a handler is cancelled
|
||||
int cancel_type (TIMER_QUEUE &timer_queue,
|
||||
ACE_Event_Handler *handler,
|
||||
int dont_call,
|
||||
int &requires_reference_counting);
|
||||
|
||||
/// This method is called when a timer is cancelled
|
||||
int cancel_timer (TIMER_QUEUE &timer_queue,
|
||||
ACE_Event_Handler *handler,
|
||||
int dont_call,
|
||||
int requires_reference_counting);
|
||||
|
||||
/// This method is called when the timer queue is destroyed and
|
||||
/// the timer is still contained in it
|
||||
int deletion (TIMER_QUEUE &timer_queue,
|
||||
ACE_Event_Handler *handler,
|
||||
const void *arg);
|
||||
|
||||
private:
|
||||
/// Timer Queue to do the calling up to
|
||||
ACE_Timer_Queue_T<TYPE, FUNCTOR, ACE_LOCK> *timer_hash_;
|
||||
|
||||
// = Don't allow these operations for now.
|
||||
ACE_UNIMPLEMENTED_FUNC (ACE_Timer_Hash_Upcall (const ACE_Timer_Hash_Upcall<TYPE, FUNCTOR, ACE_LOCK> &))
|
||||
ACE_UNIMPLEMENTED_FUNC (void operator= (const ACE_Timer_Hash_Upcall<TYPE, FUNCTOR, ACE_LOCK> &))
|
||||
};
|
||||
|
||||
/**
|
||||
* @class ACE_Timer_Hash_Iterator_T
|
||||
*
|
||||
* @brief Iterates over an ACE_Timer_Hash_T.
|
||||
*
|
||||
* This is a generic iterator that can be used to visit every
|
||||
* node of a timer queue. Be aware that it doesn't transverse
|
||||
* in the order of timeout values.
|
||||
*/
|
||||
template <class TYPE, class FUNCTOR, class ACE_LOCK, class BUCKET>
|
||||
class ACE_Timer_Hash_Iterator_T : public ACE_Timer_Queue_Iterator_T <TYPE, FUNCTOR, ACE_LOCK>
|
||||
{
|
||||
public:
|
||||
/// Constructor.
|
||||
ACE_Timer_Hash_Iterator_T (ACE_Timer_Hash_T<TYPE, FUNCTOR, ACE_LOCK, BUCKET> &);
|
||||
|
||||
/// Positions the iterator at the earliest node in the Timer Queue
|
||||
virtual void first (void);
|
||||
|
||||
/// Positions the iterator at the next node in the Timer Queue
|
||||
virtual void next (void);
|
||||
|
||||
/// Returns true when there are no more nodes in the sequence
|
||||
virtual bool isdone (void) const;
|
||||
|
||||
/// Returns the node at the current position in the sequence
|
||||
virtual ACE_Timer_Node_T<TYPE> *item (void);
|
||||
|
||||
protected:
|
||||
/// Pointer to the ACE_Timer_Hash that we are iterating over.
|
||||
ACE_Timer_Hash_T<TYPE, FUNCTOR, ACE_LOCK, BUCKET> &timer_hash_;
|
||||
|
||||
/// Current position in <timer_hash_>'s table
|
||||
size_t position_;
|
||||
|
||||
/// Current iterator used on <position>'s bucket
|
||||
ACE_Timer_Queue_Iterator_T<TYPE, ACE_Timer_Hash_Upcall<TYPE, FUNCTOR, ACE_LOCK>, ACE_Null_Mutex> *iter_;
|
||||
};
|
||||
|
||||
/**
|
||||
* @class ACE_Timer_Hash_T
|
||||
*
|
||||
* @brief Provides a hash table of BUCKETs as an implementation for
|
||||
* a timer queue.
|
||||
*
|
||||
* This implementation uses a hash table of BUCKETs. The hash
|
||||
* is based on the time_value of the event. Unlike other Timer
|
||||
* Queues, ACE_Timer_Hash does not expire events in order.
|
||||
*/
|
||||
template <class TYPE, class FUNCTOR, class ACE_LOCK, class BUCKET>
|
||||
class ACE_Timer_Hash_T : public ACE_Timer_Queue_T<TYPE, FUNCTOR, ACE_LOCK>
|
||||
{
|
||||
public:
|
||||
/// Type of iterator
|
||||
typedef ACE_Timer_Hash_Iterator_T<TYPE, FUNCTOR, ACE_LOCK, BUCKET>
|
||||
HASH_ITERATOR;
|
||||
|
||||
/// Iterator is a friend
|
||||
friend class ACE_Timer_Hash_Iterator_T<TYPE, FUNCTOR, ACE_LOCK, BUCKET>;
|
||||
|
||||
/// Type inherited from
|
||||
typedef ACE_Timer_Queue_T<TYPE, FUNCTOR, ACE_LOCK> INHERITED;
|
||||
|
||||
// = Initialization and termination methods.
|
||||
/**
|
||||
* Default constructor. @a table_size determines the size of the
|
||||
* hash table. @a upcall_functor is the instance of the FUNCTOR
|
||||
* to be used by the buckets. If @a upcall_functor is 0, a default
|
||||
* FUNCTOR will be created.
|
||||
*/
|
||||
ACE_Timer_Hash_T (size_t table_size,
|
||||
FUNCTOR *upcall_functor = 0,
|
||||
ACE_Free_List<ACE_Timer_Node_T <TYPE> > *freelist = 0);
|
||||
|
||||
/**
|
||||
* Default constructor. @a upcall_functor is the instance of the
|
||||
* FUNCTOR to be used by the queue. If @a upcall_functor is 0, Timer
|
||||
* Hash will create a default FUNCTOR. @a freelist the freelist of
|
||||
* timer nodes. If 0, then a default freelist will be created. The default
|
||||
* size will be ACE_DEFAULT_TIMERS and there will be no preallocation.
|
||||
*/
|
||||
ACE_Timer_Hash_T (FUNCTOR *upcall_functor = 0, ACE_Free_List<ACE_Timer_Node_T <TYPE> > *freelist = 0);
|
||||
|
||||
/// Destructor
|
||||
virtual ~ACE_Timer_Hash_T (void);
|
||||
|
||||
/// True if queue is empty, else false.
|
||||
virtual bool is_empty (void) const;
|
||||
|
||||
/// Returns the time of the earlier node in the <ACE_Timer_Hash>.
|
||||
/// Must be called on a non-empty queue.
|
||||
virtual const ACE_Time_Value &earliest_time (void) const;
|
||||
|
||||
/**
|
||||
* Resets the interval of the timer represented by @a timer_id to
|
||||
* @a interval, which is specified in relative time to the current
|
||||
* <gettimeofday>. If @a interval is equal to
|
||||
* ACE_Time_Value::zero, the timer will become a non-rescheduling
|
||||
* timer. Returns 0 if successful, -1 if not.
|
||||
*/
|
||||
virtual int reset_interval (long timer_id,
|
||||
const ACE_Time_Value &interval);
|
||||
|
||||
/**
|
||||
* Cancel all timer associated with @a type. If <dont_call> is 0
|
||||
* then the <functor> will be invoked. Returns number of timers
|
||||
* cancelled. If any valid timer is not cancelled before destruction
|
||||
* of this instance of ACE_Timer_Hash_T then user will get a memory
|
||||
* leak.
|
||||
*/
|
||||
virtual int cancel (const TYPE &type,
|
||||
int dont_call_handle_close = 1);
|
||||
|
||||
/**
|
||||
* Cancel the single timer that matches the @a timer_id value (which
|
||||
* was returned from the <schedule> method). If act is non-NULL
|
||||
* then it will be set to point to the ``magic cookie'' argument
|
||||
* passed in when the timer was registered. This makes it possible
|
||||
* to free up the memory and avoid memory leaks. If <dont_call> is
|
||||
* 0 then the <functor> will be invoked. Returns 1 if cancellation
|
||||
* succeeded and 0 if the @a timer_id wasn't found. If any valid
|
||||
* timer is not cancelled before destruction of this instance of
|
||||
* ACE_Timer_Hash_T then user will get a memory leak.
|
||||
*/
|
||||
virtual int cancel (long timer_id,
|
||||
const void **act = 0,
|
||||
int dont_call_handle_close = 1);
|
||||
|
||||
/**
|
||||
* Run the <functor> for all timers whose values are <=
|
||||
* <ACE_OS::gettimeofday>. Also accounts for <timer_skew>. Returns
|
||||
* the number of timers canceled.
|
||||
*/
|
||||
virtual int expire (void);
|
||||
|
||||
/**
|
||||
* Run the <functor> for all timers whose values are <= @a current_time.
|
||||
* This does not account for <timer_skew>. Returns the number of
|
||||
* timers canceled.
|
||||
*/
|
||||
virtual int expire (const ACE_Time_Value ¤t_time);
|
||||
|
||||
/// Returns a pointer to this ACE_Timer_Queue's iterator.
|
||||
virtual ACE_Timer_Queue_Iterator_T<TYPE, FUNCTOR, ACE_LOCK> &iter (void);
|
||||
|
||||
/// Removes the earliest node from the queue and returns it
|
||||
virtual ACE_Timer_Node_T<TYPE> *remove_first (void);
|
||||
|
||||
/// Dump the state of an object.
|
||||
virtual void dump (void) const;
|
||||
|
||||
/// Reads the earliest node from the queue and returns it.
|
||||
virtual ACE_Timer_Node_T<TYPE> *get_first (void);
|
||||
|
||||
protected:
|
||||
/// Factory method that frees a previously allocated node.
|
||||
virtual void free_node (ACE_Timer_Node_T<TYPE> *);
|
||||
|
||||
private:
|
||||
|
||||
/**
|
||||
* Schedule @a type that will expire at @a future_time,
|
||||
* which is specified in absolute time. If it expires then @a act is
|
||||
* passed in as the value to the <functor>. If @a interval is != to
|
||||
* ACE_Time_Value::zero then it is used to reschedule the @a type
|
||||
* automatically, using relative time to the current <gettimeofday>.
|
||||
* This method returns a <timer_id> that is a pointer to a token
|
||||
* which stores information about the event. This <timer_id> can be
|
||||
* used to cancel the timer before it expires. Returns -1 on
|
||||
* failure.
|
||||
*/
|
||||
virtual long schedule_i (const TYPE &type,
|
||||
const void *act,
|
||||
const ACE_Time_Value &future_time,
|
||||
const ACE_Time_Value &interval);
|
||||
|
||||
/// Non-locking version of dispatch_info ()
|
||||
virtual int dispatch_info_i (const ACE_Time_Value ¤t_time,
|
||||
ACE_Timer_Node_Dispatch_Info_T<TYPE> &info);
|
||||
|
||||
/// Reschedule an "interval" ACE_Timer_Node.
|
||||
virtual void reschedule (ACE_Timer_Node_T<TYPE> *);
|
||||
|
||||
/// Finds the earliest node
|
||||
void find_new_earliest (void);
|
||||
|
||||
/// Keeps track of the size of the queue
|
||||
size_t size_;
|
||||
|
||||
/// Table of BUCKETS
|
||||
BUCKET **table_;
|
||||
|
||||
/// Keeps track of the size of table_
|
||||
size_t table_size_;
|
||||
|
||||
/// Functor used for the table's timer queues
|
||||
ACE_Timer_Hash_Upcall<TYPE, FUNCTOR, ACE_LOCK> table_functor_;
|
||||
|
||||
/// Index to the position with the earliest entry
|
||||
size_t earliest_position_;
|
||||
|
||||
/// Iterator used to expire timers.
|
||||
HASH_ITERATOR *iterator_;
|
||||
|
||||
#if defined (ACE_WIN64)
|
||||
// Part of a hack... see comments in schedule().
|
||||
// This is, essentially, the upper 32 bits of a 64-bit pointer on Win64.
|
||||
ptrdiff_t pointer_base_;
|
||||
#endif
|
||||
|
||||
/// Hash_Token is usually allocated in schedule but its
|
||||
/// deallocation is problematic and token_list_ helps with this.
|
||||
ACE_Locked_Free_List<Hash_Token<TYPE>, ACE_Null_Mutex> token_list_;
|
||||
|
||||
// = Don't allow these operations for now.
|
||||
ACE_UNIMPLEMENTED_FUNC (ACE_Timer_Hash_T (const ACE_Timer_Hash_T<TYPE, FUNCTOR, ACE_LOCK, BUCKET> &))
|
||||
ACE_UNIMPLEMENTED_FUNC (void operator= (const ACE_Timer_Hash_T<TYPE, FUNCTOR, ACE_LOCK, BUCKET> &))
|
||||
};
|
||||
|
||||
ACE_END_VERSIONED_NAMESPACE_DECL
|
||||
|
||||
#if defined (ACE_TEMPLATES_REQUIRE_SOURCE)
|
||||
#include "ace/Timer_Hash_T.cpp"
|
||||
#endif /* ACE_TEMPLATES_REQUIRE_SOURCE */
|
||||
|
||||
#if defined (ACE_TEMPLATES_REQUIRE_PRAGMA)
|
||||
#pragma implementation ("Timer_Hash_T.cpp")
|
||||
#endif /* ACE_TEMPLATES_REQUIRE_PRAGMA */
|
||||
|
||||
#include /**/ "ace/post.h"
|
||||
#endif /* ACE_TIMER_HASH_T_H */
|
||||
Reference in New Issue
Block a user