抛弃GdCpp*.dll/pdb历史重新建库。libhv和Sqlite的dll保留

include/CSQLite/CSQLiteTransaction.h

@@ -0,0 +1,71 @@
+/**
+ * @file    Transaction.h
+ * @ingroup SQLiteCpp
+ * @brief   A Transaction is way to group multiple SQL statements into an atomic secured operation.
+ *
+ * Copyright (c) 2012-2019 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 "GdCPP_Exports.h"
+
+// Forward declaration
+class CSQLiteDB;
+
+
+/**
+ * @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 GDCPP_API CSQLiteTransaction
+{
+public:
+    /**
+     * @brief Begins the SQLite transaction
+     *
+     * @param[in] aDatabase the SQLite Database Connection
+     *
+     * Exception is thrown in case of error, then the Transaction is NOT initiated.
+     */
+    explicit CSQLiteTransaction(CSQLiteDB& aDatabase, bool startnow=true);
+
+    /**
+     * @brief Safely rollback the transaction if it has not been committed.
+     */
+    ~CSQLiteTransaction();
+
+    /**
+     * @brief Commit the transaction.
+     */
+    void commit();
+
+private:
+    // Transaction must be non-copyable
+    CSQLiteTransaction(const CSQLiteTransaction&);
+    CSQLiteTransaction& operator=(const CSQLiteTransaction&);
+    /// @}
+
+private:
+    CSQLiteDB&   mDatabase;  ///< Reference to the SQLite Database Connection
+    bool        mbCommited; ///< True when commit has been called
+};
+