Sirikata
|
00001 /* Sirikata 00002 * ObjectReference.hpp 00003 * 00004 * Copyright (c) 2009, 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 #ifndef _OBJECT_REFERENCE_HPP_ 00033 #define _OBJECT_REFERENCE_HPP_ 00034 00035 #include "UUID.hpp" 00036 00037 namespace Sirikata { 00038 00045 class SIRIKATA_EXPORT ObjectReference : public TotallyOrdered<ObjectReference>{ 00046 public: 00047 enum {static_size=UUID::static_size}; 00048 ObjectReference(); 00049 explicit ObjectReference(const UUID& id); 00050 explicit ObjectReference(const String& str); 00051 explicit ObjectReference(const UUID::Data &data); 00052 00053 UUID::Data toRawBytes() const 00054 { return mID.getArray(); } 00055 00056 String toRawHexData() const 00057 { return mID.rawHexData(); } 00058 00059 static const ObjectReference &null(){ 00060 static ObjectReference retval(UUID::null()); 00061 return retval; 00062 } 00064 static const ObjectReference &any() { 00065 static ObjectReference retval(UUID::max()); 00066 return retval; 00067 } 00068 00069 static ObjectReference random() { 00070 return ObjectReference(UUID::random()); 00071 } 00072 00073 static const ObjectReference &spaceServiceID() { 00074 return null(); 00075 } 00076 String toString() const{ 00077 return mID.readableHexData(); 00078 } 00079 class Hasher {public: 00080 size_t operator()(const ObjectReference&objr) const { 00081 return objr.hash(); 00082 } 00083 }; 00084 size_t hash() const{ 00085 return mID.hash(); 00086 } 00087 00088 class Null { 00089 public: 00090 const ObjectReference& operator()() const { 00091 return ObjectReference::null(); 00092 } 00093 }; 00094 class Random { 00095 public: 00096 ObjectReference operator()() const { 00097 return ObjectReference::random(); 00098 } 00099 }; 00100 00104 const UUID& getObjectUUID() const{ 00105 return mID; 00106 } 00107 00111 UUID getAsUUID() const { 00112 return mID; 00113 } 00114 bool isNull() const{ 00115 return mID.isNull(); 00116 } 00117 bool operator==(const ObjectReference& rhs) const{ 00118 return mID==rhs.mID; 00119 } 00120 bool operator<(const ObjectReference& rhs) const{ 00121 return mID<rhs.mID; 00122 } 00123 00124 bool matches(const ObjectReference& rhs) const { 00125 return ( 00126 *this == rhs || 00127 *this == any() || 00128 rhs == any() 00129 ); 00130 } 00131 private: 00132 00133 UUID mID; 00134 00135 }; 00136 00137 inline std::ostream &operator << (std::ostream &os, const ObjectReference&objRef) { 00138 os << objRef.toString(); 00139 return os; 00140 } 00141 00142 } // namespace Sirikata 00143 00144 #endif //_OBJECT_REFERENCE_HPP_