4
* Copyright (C) 2009 Tim Marston <tim@ed.am>
4
* Copyright (C) 2009 Tim Marston <edam@waxworlds.org>
6
6
* This file is part of sqlite3cc (hereafter referred to as "this program").
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
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.
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/>.
39
* A basic (default, deferred) transaction.
41
class basic_transaction
43
private boost::noncopyable
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.
45
//______________________________________________________________________________
50
* Constructor that provides a database upon which to act
51
* @param database a database
53
explicit basic_transaction(
56
//______________________________________________________________________________
61
* Begin the transaction
66
* Commit the transaction
68
virtual void commit();
71
* Rollback the transaction
73
virtual void rollback();
75
//______________________________________________________________________________
79
/* the database on which to act */
85
////////////////////////////////////////////////////////////////////////////////
89
* An exclusive transaction
109
91
class immediate_transaction
111
public detail::basic_transaction
93
public basic_transaction
113
95
//______________________________________________________________________________
118
* Constructor that provides a connection upon which to act.
120
* @param connection a connection
100
* Constructor that provides a database upon which to act
101
* @param database a database
122
103
explicit immediate_transaction(
123
connection &connection );
104
database &database );
125
106
//______________________________________________________________________________
126
107
// public interface
130
* Begin the transaction.
111
* Begin the transaction
132
113
virtual void begin();
141
* An exclusive transaction.
122
* An exclusive transaction
143
124
class exclusive_transaction
145
public detail::basic_transaction
126
public basic_transaction
147
128
//______________________________________________________________________________
152
* Constructor that provides a connection upon which to act.
154
* @param connection a connection
133
* Constructor that provides a database upon which to act
134
* @param database a database
156
136
explicit exclusive_transaction(
157
connection &connection );
137
database &database );
159
139
//______________________________________________________________________________
160
140
// public interface
177
157
class recursive_transaction
179
public detail::basic_transaction
159
public basic_transaction
181
161
//______________________________________________________________________________
186
* Constructor that provides a connection upon which to act.
188
* @param connection a connection
166
* Constructor that provides a database upon which to act
167
* @param database a database
190
169
explicit recursive_transaction(
191
connection &connection );
170
database &database );
193
172
//______________________________________________________________________________
194
173
// public interface
198
* Begin the transaction.
177
* Begin the transaction
200
179
virtual void begin();
203
* Commit the transaction.
182
* Commit the transaction
205
184
virtual void commit();
208
* Rollback the transaction.
187
* Rollback the transaction
210
189
virtual void rollback();
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.
205
* A scope guard, or sentinel for use with one of the transaction classes.
229
template< class T = deferred_transaction >
207
template< class T = basic_transaction >
230
208
class transaction_guard
232
210
private boost::noncopyable
239
* Constructor that provides a connection upon which to act.
241
* @param connection a connection
217
* Constructor that provides a database upon which to act
218
* @param database a database
243
220
explicit transaction_guard(
244
connection &connection )
246
_transaction( connection ),
223
_transaction( database ),
249
226
_transaction.begin();
253
229
~transaction_guard()
256
_transaction.rollback();
233
_transaction.rollback();
259
240
//______________________________________________________________________________
287
* Rollback the transaction. Note that this is done automatically in the
288
* destructor if the transaction hasn't otherwise been completed.
293
_transaction.rollback();
298
255
//______________________________________________________________________________
299
256
// implementation
302
/** the transaction */
259
/* the transaction */
305
/** have we released the transaction yet? */
262
/* have we released the transaction yet? */