mirror of
https://github.com/open-goal/jak-project
synced 2026-05-29 16:45:10 -04:00
Tyler Wilding
bf83f2442d
- Rough start of the SQLite integration to facilitate the SQL queries - Cleanup and disable a little bit of code so the game no longer crashes when entering the editor - Implement some of the mouse data stuff  https://user-images.githubusercontent.com/13153231/202881484-399747e7-dcdb-4e09-93e9-b561a45c8a18.mp4 This is a very old branch so best to get it merged now that it's at a decent point so it can be iterated on.
96 lines
3.0 KiB
C++
Vendored
Generated
96 lines
3.0 KiB
C++
Vendored
Generated
/**
|
|
* @file Transaction.h
|
|
* @ingroup SQLiteCpp
|
|
* @brief A Transaction is way to group multiple SQL statements into an atomic secured operation.
|
|
*
|
|
* Copyright (c) 2012-2022 Sebastien Rombauts (sebastien.rombauts@gmail.com)
|
|
*
|
|
* Distributed under the MIT License (MIT) (See accompanying file LICENSE.txt
|
|
* or copy at http://opensource.org/licenses/MIT)
|
|
*/
|
|
#pragma once
|
|
|
|
#include <SQLiteCpp/Exception.h>
|
|
|
|
|
|
namespace SQLite
|
|
{
|
|
|
|
|
|
// Forward declaration
|
|
class Database;
|
|
|
|
/**
|
|
* @brief Transaction behaviors when opening an SQLite transaction.
|
|
* Names correspond directly to the behavior.
|
|
*/
|
|
enum class TransactionBehavior {
|
|
DEFERRED,
|
|
IMMEDIATE,
|
|
EXCLUSIVE,
|
|
};
|
|
|
|
/**
|
|
* @brief RAII encapsulation of a SQLite Transaction.
|
|
*
|
|
* A Transaction is a way to group multiple SQL statements into an atomic secured operation;
|
|
* either it succeeds, with all the changes committed to the database file,
|
|
* or if it fails, all the changes are rolled back to the initial state.
|
|
*
|
|
* Resource Acquisition Is Initialization (RAII) means that the Transaction
|
|
* begins in the constructor and is rollbacked in the destructor, so that there is
|
|
* no need to worry about memory management or the validity of the underlying SQLite Connection.
|
|
*
|
|
* This method also offers big performances improvements compared to individually executed statements.
|
|
*
|
|
* Thread-safety: a Transaction object shall not be shared by multiple threads, because :
|
|
* 1) in the SQLite "Thread Safe" mode, "SQLite can be safely used by multiple threads
|
|
* provided that no single database connection is used simultaneously in two or more threads."
|
|
* 2) the SQLite "Serialized" mode is not supported by SQLiteC++,
|
|
* because of the way it shares the underling SQLite precompiled statement
|
|
* in a custom shared pointer (See the inner class "Statement::Ptr").
|
|
*/
|
|
class Transaction
|
|
{
|
|
public:
|
|
/**
|
|
* @brief Begins the SQLite transaction using the default transaction behavior.
|
|
*
|
|
* @param[in] aDatabase the SQLite Database Connection
|
|
*
|
|
* Exception is thrown in case of error, then the Transaction is NOT initiated.
|
|
*/
|
|
explicit Transaction(Database& aDatabase);
|
|
|
|
/**
|
|
* @brief Begins the SQLite transaction with the specified behavior.
|
|
*
|
|
* @param[in] aDatabase the SQLite Database Connection
|
|
* @param[in] behavior the requested transaction behavior
|
|
*
|
|
* Exception is thrown in case of error, then the Transaction is NOT initiated.
|
|
*/
|
|
explicit Transaction(Database& aDatabase, TransactionBehavior behavior);
|
|
|
|
// Transaction is non-copyable
|
|
Transaction(const Transaction&) = delete;
|
|
Transaction& operator=(const Transaction&) = delete;
|
|
|
|
/**
|
|
* @brief Safely rollback the transaction if it has not been committed.
|
|
*/
|
|
~Transaction();
|
|
|
|
/**
|
|
* @brief Commit the transaction.
|
|
*/
|
|
void commit();
|
|
|
|
private:
|
|
Database& mDatabase; ///< Reference to the SQLite Database Connection
|
|
bool mbCommited = false; ///< True when commit has been called
|
|
};
|
|
|
|
|
|
} // namespace SQLite
|