Sirikata
libcore/include/sirikata/core/network/IOTimer.hpp
Go to the documentation of this file.
00001 /*  Sirikata Network Utilities
00002  *  IOTimer.hpp
00003  *
00004  *  Copyright (c) 2009, Daniel Reiter Horn
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_IOTIMER_HPP_
00033 #define _SIRIKATA_IOTIMER_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/SerializationCheck.hpp>
00039 
00040 namespace Sirikata {
00041 namespace Network {
00042 
00043 typedef std::tr1::shared_ptr<IOTimer> IOTimerPtr;
00044 typedef std::tr1::weak_ptr<IOTimer> IOTimerWPtr;
00045 
00065 class SIRIKATA_EXPORT IOTimer : public std::tr1::enable_shared_from_this<IOTimer> {
00066     DeadlineTimer *mTimer;
00067     IOStrand* mStrand;
00068     IOCallback mFunc;
00069     SerializationCheck chk;
00070 
00084     AtomicValue<uint32> mCanceled;
00085 
00086     class TimedOut;
00087 
00088 
00092     IOTimer(IOService &io);
00093 
00098     IOTimer(IOService &io, const IOCallback& cb);
00099 
00103     IOTimer(IOStrand* ios);
00104 
00109     IOTimer(IOStrand* ios, const IOCallback& cb);
00110 
00111 public:
00115     static IOTimerPtr create(IOService *io);
00116     static IOTimerPtr create(IOService &io);
00120     static IOTimerPtr create(IOStrand *ios);
00121     static IOTimerPtr create(IOStrand &ios);
00122 
00127     static IOTimerPtr create(IOService *io, const IOCallback& cb);
00128     static IOTimerPtr create(IOService &io, const IOCallback& cb);
00133     static IOTimerPtr create(IOStrand *ios, const IOCallback& cb);
00134     static IOTimerPtr create(IOStrand &ios, const IOCallback& cb);
00135 
00136     ~IOTimer();
00137 
00142     void setCallback(const IOCallback& cb);
00143 
00147     void wait(const Duration &waitFor);
00148 
00153     void wait(const Duration &waitFor, const IOCallback& cb);
00154 
00158     void cancel();
00159     Duration expiresFromNow();
00160 };
00161 
00162 } // namespace Network
00163 } // namespace Sirikata
00164 
00165 #endif //_SIRIKATA_IOTIMER_HPP_