Sirikata
|
00001 /* Sirikata Network Utilities 00002 * IOStrand.hpp 00003 * 00004 * Copyright (c) 2009, Ewen Cheslack-Postava 00005 * All rights reserved. 00006 * 00007 * Redistribution and use in source and binary forms, with or without 00008 * modification, are permitted provided that the following conditions are 00009 * met: 00010 * * Redistributions of source code must retain the above copyright 00011 * notice, this list of conditions and the following disclaimer. 00012 * * Redistributions in binary form must reproduce the above copyright 00013 * notice, this list of conditions and the following disclaimer in 00014 * the documentation and/or other materials provided with the 00015 * distribution. 00016 * * Neither the name of Sirikata nor the names of its contributors may 00017 * be used to endorse or promote products derived from this software 00018 * without specific prior written permission. 00019 * 00020 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS 00021 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 00022 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 00023 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER 00024 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 00025 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 00026 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 00027 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 00028 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 00029 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 00030 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00031 */ 00032 #ifndef _SIRIKATA_IOSTRAND_HPP_ 00033 #define _SIRIKATA_IOSTRAND_HPP_ 00034 00035 #include <sirikata/core/util/Platform.hpp> 00036 #include <sirikata/core/network/IODefs.hpp> 00037 #include <sirikata/core/util/AtomicTypes.hpp> 00038 #include <sirikata/core/util/Noncopyable.hpp> 00039 #include <sirikata/core/trace/WindowedStats.hpp> 00040 #include <sirikata/core/task/Time.hpp> 00041 #include <boost/thread.hpp> 00042 00043 namespace Sirikata { 00044 namespace Network { 00045 00059 class SIRIKATA_EXPORT IOStrand : public Noncopyable { 00060 public: 00061 typedef std::tr1::unordered_map<const char*, uint32> TagCountMap; 00062 00063 private: 00064 IOService& mService; 00065 InternalIOStrand* mImpl; 00066 const String mName; 00067 00068 #ifdef SIRIKATA_TRACK_EVENT_QUEUES 00069 // Track all strands that have been allocated. This needs to be 00070 // thread safe. 00071 typedef boost::mutex Mutex; 00072 typedef boost::lock_guard<Mutex> LockGuard; 00073 Mutex mMutex; 00074 00075 AtomicValue<uint32> mTimersEnqueued; 00076 AtomicValue<uint32> mEnqueued; 00077 00078 // Tracks the latency of recent handlers through the queue 00079 Trace::WindowedStats<Duration> mWindowedTimerLatencyStats; 00080 Trace::WindowedStats<Duration> mWindowedHandlerLatencyStats; 00081 00082 // Track tags that trigger events 00083 TagCountMap mTagCounts; 00084 #endif 00085 00086 friend class IOService; 00087 00089 IOStrand(IOService& io, const String& name); 00090 00091 #ifdef SIRIKATA_TRACK_EVENT_QUEUES 00092 void decrementTimerCount(const Time& start, const Duration& timer_duration, const IOCallback& cb, const char* tag); 00093 void decrementCount(const Time& start, const IOCallback& cb, const char* tag); 00094 #endif 00095 00096 protected: 00097 00098 friend class StrandTCPSocket; 00099 00100 public: 00101 00102 template<typename CallbackType> 00103 class WrappedHandler; 00104 00108 ~IOStrand(); 00109 00113 const String& name() const { return mName; } 00114 00116 IOService& service() const; 00117 00123 void dispatch(const IOCallback& handler, const char* tag = NULL); 00124 00132 void post(const IOCallback& handler, const char* tag = NULL); 00141 void post(const Duration& waitFor, const IOCallback& handler, const char* tag = NULL); 00142 00148 IOCallback wrap(const IOCallback& handler); 00149 00150 00156 template<typename CallbackType> 00157 WrappedHandler<CallbackType> wrap(const CallbackType& handler); 00158 00159 00160 00161 #ifdef SIRIKATA_TRACK_EVENT_QUEUES 00162 uint32 numTimersEnqueued() const { return mTimersEnqueued.read(); } 00163 uint32 numEnqueued() const { return mEnqueued.read(); } 00164 00165 Duration timerLatency() const { return mWindowedTimerLatencyStats.average(); } 00166 Duration handlerLatency() const { return mWindowedHandlerLatencyStats.average(); } 00167 00168 TagCountMap enqueuedTags() const; 00169 #endif 00170 00171 }; 00172 00173 typedef std::tr1::shared_ptr<IOStrand> IOStrandPtr; 00174 00175 } // namespace Network 00176 } // namespace Sirikata 00177 00178 #endif //_SIRIKATA_IOSERVICE_HPP_