4
* Copyright (C) 2009 Tim Marston <edam@waxworlds.org>
4
* Copyright (C) 2009 Tim Marston <tim@ed.am>
6
6
* This file is part of sqlite3cc (hereafter referred to as "this program").
7
* See http://www.waxworlds.org/edam/software/sqlite3cc for more information.
9
* This program is free software: you can redistribute it and/or modify
10
* it under the terms of the GNU Lesser General Public License as published
11
* by the Free Software Foundation, either version 3 of the License, or
12
* (at your option) any later version.
14
* This program is distributed in the hope that it will be useful,
15
* but WITHOUT ANY WARRANTY; without even the implied warranty of
16
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17
* GNU Lesser General Public License for more details.
7
* See http://ed.am/dev/sqlite3cc for more information.
9
* This program is free software: you can redistribute it and/or modify it under
10
* the terms of the GNU Lesser General Public License as published by the Free
11
* Software Foundation, either version 3 of the License, or (at your option) any
14
* This program is distributed in the hope that it will be useful, but WITHOUT
15
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
16
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
19
19
* You should have received a copy of the GNU Lesser General Public License
20
20
* along with this program. If not, see <http://www.gnu.org/licenses/>.
38
class basic_transaction
42
* A basic (default, deferred) transaction.
44
class basic_transaction
46
private boost::noncopyable
48
//__________________________________________________________________________
53
* Constructor that provides a connection upon which to act.
55
* @param connection a connection
57
explicit basic_transaction(
58
connection &connection );
60
//__________________________________________________________________________
65
* Begin the transaction
70
* Commit the transaction
72
virtual void commit();
75
* Rollback the transaction
77
virtual void rollback();
79
//__________________________________________________________________________
83
/** reset any in-progress statements */
84
void reset_active_queries();
86
/** the connection on which to act */
87
connection &_connection;
94
////////////////////////////////////////////////////////////////////////////////
98
* A deferred transaction.
100
typedef detail::basic_transaction deferred_transaction;
103
////////////////////////////////////////////////////////////////////////////////
107
* An immediate transaction.
109
class immediate_transaction
40
private boost::noncopyable
111
public detail::basic_transaction
42
113
//______________________________________________________________________________
47
* Constructor that provides a database upon which to act
48
* @param database a database
118
* Constructor that provides a connection upon which to act.
120
* @param connection a connection
50
explicit basic_transaction(
122
explicit immediate_transaction(
123
connection &connection );
53
125
//______________________________________________________________________________
54
126
// public interface
58
* Begin the transaction
130
* Begin the transaction.
60
132
virtual void begin();
63
* Commit the transaction
65
virtual void commit();
68
* Rollback the transaction
70
virtual void rollback();
72
//______________________________________________________________________________
76
/* the database on which to act */
82
137
////////////////////////////////////////////////////////////////////////////////
141
* An exclusive transaction.
85
143
class exclusive_transaction
87
public basic_transaction
145
public detail::basic_transaction
89
147
//______________________________________________________________________________
94
* Constructor that provides a database upon which to act
95
* @param database a database
152
* Constructor that provides a connection upon which to act.
154
* @param connection a connection
97
156
explicit exclusive_transaction(
157
connection &connection );
100
159
//______________________________________________________________________________
101
160
// public interface
112
171
////////////////////////////////////////////////////////////////////////////////
175
* A recursive transaction, allowing transactions to be nested.
115
177
class recursive_transaction
117
public basic_transaction
179
public detail::basic_transaction
119
181
//______________________________________________________________________________
124
* Constructor that provides a database upon which to act
125
* @param database a database
186
* Constructor that provides a connection upon which to act.
188
* @param connection a connection
127
190
explicit recursive_transaction(
128
database &database );
191
connection &connection );
130
193
//______________________________________________________________________________
131
194
// public interface
135
* Begin the transaction
198
* Begin the transaction.
137
200
virtual void begin();
140
* Commit the transaction
203
* Commit the transaction.
142
205
virtual void commit();
145
* Rollback the transaction
208
* Rollback the transaction.
147
210
virtual void rollback();
159
222
////////////////////////////////////////////////////////////////////////////////
162
template< class T = basic_transaction >
226
* A scope guard (sentinel) for use with one of the transaction classes to
227
* provide RAII-style transactions. It defaults to using deferred transactions.
229
template< class T = deferred_transaction >
163
230
class transaction_guard
165
232
private boost::noncopyable
172
* Constructor that provides a database upon which to act
173
* @param database a database
239
* Constructor that provides a connection upon which to act.
241
* @param connection a connection
175
243
explicit transaction_guard(
244
connection &connection )
178
_transaction( database ),
246
_transaction( connection ),
181
249
_transaction.begin();
184
253
~transaction_guard()
188
_transaction.rollback();
256
_transaction.rollback();
195
259
//______________________________________________________________________________