Sirikata
|
00001 /* Sirikata -- SQLite plugin 00002 * SQLite.hpp 00003 * 00004 * Copyright (c) 2008, 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 _SQLITE_HPP_ 00034 #define _SQLITE_HPP_ 00035 00036 #include <sirikata/sqlite/Platform.hpp> 00037 #include <boost/thread/shared_mutex.hpp> 00038 #include <boost/thread/tss.hpp> 00039 #include <boost/thread/locks.hpp> 00040 #include <sqlite3.h> 00041 00042 namespace Sirikata { 00043 00045 class SIRIKATA_SQLITE_EXPORT SQLiteDB { 00046 public: 00047 SQLiteDB(const String& name); 00048 ~SQLiteDB(); 00049 00050 sqlite3* db() const; 00051 private: 00052 sqlite3* mObjectDB; 00053 }; 00054 00055 typedef std::tr1::shared_ptr<SQLiteDB> SQLiteDBPtr; 00056 typedef std::tr1::weak_ptr<SQLiteDB> WeakSQLiteDBPtr; 00057 00061 class SIRIKATA_SQLITE_EXPORT SQLite : public AutoSingleton<SQLite> { 00062 public: 00063 SQLite(); 00064 ~SQLite(); 00065 00072 SQLiteDBPtr open(const String& name); 00073 // Check and report errors in SQLite. Returns true if there was an error, 00074 // false otherwise. 00075 static std::pair<bool, String> check_sql_error(sqlite3* db, int rc, char** sql_error_msg, const String& msg); 00076 // Get a string description of a result code 00077 static const String& resultAsString(int rc); 00078 00079 static SQLite& getSingleton(); 00080 static void destroy(); 00081 private: 00082 typedef boost::thread_specific_ptr<WeakSQLiteDBPtr> ThreadDBPtr; 00083 typedef std::map<String, std::tr1::shared_ptr<ThreadDBPtr> > DBMap; 00084 00085 typedef boost::shared_mutex SharedMutex; 00086 typedef boost::shared_lock<SharedMutex> SharedLock; 00087 typedef boost::upgrade_lock<SharedMutex> UpgradeLock; 00088 typedef boost::upgrade_to_unique_lock<SharedMutex> UpgradedLock; 00089 typedef boost::unique_lock<SharedMutex> ExclusiveLock; 00090 00091 DBMap mDBs; 00092 SharedMutex mDBMutex; 00093 }; 00094 00095 } // namespace Sirikata 00096 00097 #endif //_SQLITE_HPP_