StormByte-Database 3.0.0
C++26 database module of the StormByte suite
Loading...
Searching...
No Matches
transaction.hxx
Go to the documentation of this file.
1/*
2 * Copyright (C) 2024-2026 David C. Manuelda (StormBytePP)
3 *
4 * This file is part of StormByte-Database.
5 *
6 * StormByte-Database original source is dual-licensed:
7 *
8 * 1. GNU Lesser General Public License v3.0 (or later)
9 * You may redistribute and/or modify this file under the terms of the
10 * GNU Lesser General Public License as published by the Free Software
11 * Foundation, either version 3 of the License, or (at your option)
12 * any later version.
13 *
14 * 2. Commercial license
15 * Alternatively, this file may be used under the terms of a commercial
16 * license agreement with the copyright holder
17 * (David C. Manuelda <StormByte@gmail.com>).
18 *
19 * Both licenses apply only to original StormByte-Database source in this
20 * repository. They do not cover other StormByte modules or any third-party
21 * material shipped with this repository (including everything under
22 * thirdparty/, and in particular the bundled StormByte-Logger tree and
23 * the PostgreSQL, MariaDB and SQLite trees), which remain under their own
24 * licenses.
25 *
26 * Neither license grants any patent rights. Any patent licenses required
27 * to use this software or third-party components must be obtained separately
28 * from the patent holders.
29 *
30 * StormByte-Database is distributed in the hope that it will be useful,
31 * but WITHOUT ANY WARRANTY; without even the implied warranty of
32 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
33 * GNU Lesser General Public License for more details.
34 *
35 * You should have received a copy of the GNU Lesser General Public License
36 * version 3 along with StormByte-Database. If not, see
37 * <https://www.gnu.org/licenses/lgpl-3.0.html>.
38 *
39 * SPDX-License-Identifier: LGPL-3.0-or-later OR LicenseRef-StormByte-Commercial
40 */
41
42#pragma once
43
45#include <StormByte/safe/pointers.hxx>
46
51namespace StormByte {
56 namespace Database {
57 class Database;
58
65 public:
70 explicit Transaction(Database &db);
71
75 Transaction(const Transaction &) = delete;
76
80 Transaction &operator=(const Transaction &) = delete;
81
86 Transaction(Transaction &&other) noexcept;
87
93 Transaction &operator=(Transaction &&other) noexcept;
94
98 ~Transaction() noexcept;
99
103 void Commit();
104
108 void Rollback();
109
114 bool IsActive() const noexcept {
115 return m_active;
116 }
117
118 private:
123 class ConnectionLock;
124 Database *m_db;
125 bool m_active;
126 bool m_lock_held;
127
131 void ReleaseLock() noexcept;
132 };
133 }
134}
135
Abstract backend.
Definition database.hxx:73
RAII transaction.
Definition transaction.hxx:64
bool IsActive() const noexcept
Whether neither Commit nor Rollback has been called.
Definition transaction.hxx:114
Transaction & operator=(Transaction &&other) noexcept
Move assignment.
Transaction(Database &db)
Bind to a database connection.
~Transaction() noexcept
Destructor.
Transaction & operator=(const Transaction &)=delete
Copy assignment (deleted).
Transaction(const Transaction &)=delete
Copy constructor (deleted).
Transaction(Transaction &&other) noexcept
Move constructor.
STORMBYTE_DECLARE_MAYBE_SAFE(StormByte::Logger::Exception)
Database module of the StormByte suite.
Root namespace of the StormByte C++ suite.
#define STORMBYTE_DATABASE_PUBLIC
Definition visibility.h:54