Sirikata
libcore/include/sirikata/core/util/Liveness.hpp
Go to the documentation of this file.
00001 /*  Sirikata
00002  *  Liveness.hpp
00003  *
00004  *  Copyright (c) 2011, Stanford University
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 
00033 #ifndef _SIRIKATA_CORE_UTIL_LIVENESS_TOKEN_HPP_
00034 #define _SIRIKATA_CORE_UTIL_LIVENESS_TOKEN_HPP_
00035 
00036 namespace Sirikata {
00037 
00099 class SIRIKATA_EXPORT Liveness {
00100     typedef std::tr1::shared_ptr<int> StrongInternalToken;
00101     typedef std::tr1::weak_ptr<int> InternalToken;
00102 
00103   public:
00104     struct SIRIKATA_EXPORT Token {
00105         InternalToken mData;
00106 
00107         Token(InternalToken t);
00108         operator bool() const { return mData.lock(); }
00109     };
00110 
00111     struct SIRIKATA_EXPORT Lock {
00112         StrongInternalToken mData;
00113 
00114         Lock(InternalToken t);
00115         Lock(const Token& t);
00116         operator bool() const { return mData; }
00117     };
00118 
00119     Liveness();
00120     ~Liveness();
00121 
00125     Token livenessToken() const { return Token(mLivenessStrongToken); }
00126 
00134     void letDie();
00135 
00136   protected:
00144     bool livenessAlive() const { return mLivenessStrongToken; }
00145 
00146   private:
00147     StrongInternalToken mLivenessStrongToken;
00148 };
00149 
00150 }
00151 
00152 #endif //_SIRIKATA_CORE_UTIL_LIVENESS_TOKEN_HPP_