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/>.
39
* A basic (default, deferred) transaction.
41
class basic_transaction
43
private boost::noncopyable
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
/** close any in-progress statements */
80
void invalidate_queries();
82
/** the database on which to act */
88
////////////////////////////////////////////////////////////////////////////////
92
* An exclusive 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.
94
109
class immediate_transaction
96
public basic_transaction
111
public detail::basic_transaction
98
113
//______________________________________________________________________________
103
* Constructor that provides a database upon which to act
104
* @param database a database
118
* Constructor that provides a connection upon which to act.
120
* @param connection a connection
106
122
explicit immediate_transaction(
107
database &database );
123
connection &connection );
109
125
//______________________________________________________________________________
110
126
// public interface
114
* Begin the transaction
130
* Begin the transaction.
116
132
virtual void begin();
125
* An exclusive transaction
141
* An exclusive transaction.
127
143
class exclusive_transaction
129
public basic_transaction
145
public detail::basic_transaction
131
147
//______________________________________________________________________________
136
* Constructor that provides a database upon which to act
137
* @param database a database
152
* Constructor that provides a connection upon which to act.
154
* @param connection a connection
139
156
explicit exclusive_transaction(
140
database &database );
157
connection &connection );
142
159
//______________________________________________________________________________
143
160
// public interface
160
177
class recursive_transaction
162
public basic_transaction
179
public detail::basic_transaction
164
181
//______________________________________________________________________________
169
* Constructor that provides a database upon which to act
170
* @param database a database
186
* Constructor that provides a connection upon which to act.
188
* @param connection a connection
172
190
explicit recursive_transaction(
173
database &database );
191
connection &connection );
175
193
//______________________________________________________________________________
176
194
// public interface
180
* Begin the transaction
198
* Begin the transaction.
182
200
virtual void begin();
185
* Commit the transaction
203
* Commit the transaction.
187
205
virtual void commit();
190
* Rollback the transaction
208
* Rollback the transaction.
192
210
virtual void rollback();
208
* A scope guard, or sentinel for use with one of the transaction classes.
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.
210
template< class T = basic_transaction >
229
template< class T = deferred_transaction >
211
230
class transaction_guard
213
232
private boost::noncopyable
220
* Constructor that provides a database upon which to act
221
* @param database a database
239
* Constructor that provides a connection upon which to act.
241
* @param connection a connection
223
243
explicit transaction_guard(
244
connection &connection )
226
_transaction( database ),
246
_transaction( connection ),
229
249
_transaction.begin();
232
253
~transaction_guard()
236
_transaction.rollback();
256
_transaction.rollback();
243
259
//______________________________________________________________________________