/sqlite3cc

To get this branch, use:
bzr branch http://bzr.ed.am/sqlite3cc

« back to all changes in this revision

Viewing changes to include/sqlite3cc/transaction.h

  • Committer: Tim Marston
  • Date: 2015-02-26 08:59:36 UTC
  • Revision ID: tim@ed.am-20150226085936-xe43in8bfz6f6nxb
fixed some missing/incorrect includes

Show diffs side-by-side

added added

removed removed

Lines of Context:
include/sqlite3cc/transaction.h
1
1
/*
2
2
 * transaction.h
3
3
 *
4
 
 * Copyright (C) 2009 Tim Marston <edam@waxworlds.org>
 
4
 * Copyright (C) 2009 Tim Marston <tim@ed.am>
5
5
 *
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.
8
 
 *
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.
13
 
 *
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.
 
8
 *
 
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
 
12
 * later version.
 
13
 *
 
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
 
17
 * details.
18
18
 *
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/>.
50
50
        public:
51
51
 
52
52
                /**
53
 
                 * Constructor that provides a connection upon which to act
 
53
                 * Constructor that provides a connection upon which to act.
 
54
                 *
54
55
                 * @param connection a connection
55
56
                 */
56
57
                explicit basic_transaction(
94
95
 
95
96
 
96
97
/**
97
 
 * A deferred transaction
 
98
 * A deferred transaction.
98
99
 */
99
100
typedef detail::basic_transaction deferred_transaction;
100
101
 
103
104
 
104
105
 
105
106
/**
106
 
 * An immediate transaction
 
107
 * An immediate transaction.
107
108
 */
108
109
class immediate_transaction
109
110
        :
114
115
public:
115
116
 
116
117
        /**
117
 
         * Constructor that provides a connection upon which to act
 
118
         * Constructor that provides a connection upon which to act.
 
119
         *
118
120
         * @param connection a connection
119
121
         */
120
122
        explicit immediate_transaction(
125
127
public:
126
128
 
127
129
        /**
128
 
         * Begin the transaction
 
130
         * Begin the transaction.
129
131
         */
130
132
        virtual void begin();
131
133
 
136
138
 
137
139
 
138
140
/**
139
 
 * An exclusive transaction
 
141
 * An exclusive transaction.
140
142
 */
141
143
class exclusive_transaction
142
144
        :
147
149
public:
148
150
 
149
151
        /**
150
 
         * Constructor that provides a connection upon which to act
 
152
         * Constructor that provides a connection upon which to act.
 
153
         *
151
154
         * @param connection a connection
152
155
         */
153
156
        explicit exclusive_transaction(
180
183
public:
181
184
 
182
185
        /**
183
 
         * Constructor that provides a connection upon which to act
 
186
         * Constructor that provides a connection upon which to act.
 
187
         *
184
188
         * @param connection a connection
185
189
         */
186
190
        explicit recursive_transaction(
191
195
public:
192
196
 
193
197
        /**
194
 
         * Begin the transaction
 
198
         * Begin the transaction.
195
199
         */
196
200
        virtual void begin();
197
201
 
198
202
        /**
199
 
         * Commit the transaction
 
203
         * Commit the transaction.
200
204
         */
201
205
        virtual void commit();
202
206
 
203
207
        /**
204
 
         * Rollback the transaction
 
208
         * Rollback the transaction.
205
209
         */
206
210
        virtual void rollback();
207
211
 
219
223
 
220
224
 
221
225
/**
222
 
 * A scope guard (sentinel) for use with one of the transaction
223
 
 * classes to provide RAII-style transactions. It defaults to using
224
 
 * deferred transactions.
 
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.
225
228
 */
226
229
template< class T = deferred_transaction >
227
230
class transaction_guard
233
236
public:
234
237
 
235
238
        /**
236
 
         * Constructor that provides a connection upon which to act
 
239
         * Constructor that provides a connection upon which to act.
 
240
         *
237
241
         * @param connection a connection
238
242
         */
239
243
        explicit transaction_guard(
240
244
                connection &connection )
241
245
                :
242
246
                _transaction( connection ),
243
 
                _released( false )
 
247
                _released( true )
244
248
        {
245
249
                _transaction.begin();
 
250
                _released = false;
246
251
        }
247
252
 
248
253
        ~transaction_guard()
256
261
public:
257
262
 
258
263
        /**
259
 
         * Commit the transaction
 
264
         * Begin the transaction. Note that this is done automatically in the
 
265
         * constructor.
 
266
         */
 
267
        void begin()
 
268
        {
 
269
                if( _released ) {
 
270
                        _transaction.begin();
 
271
                        _released = false;
 
272
                }
 
273
        }
 
274
 
 
275
        /**
 
276
         * Commit the transaction.
260
277
         */
261
278
        void commit()
262
279
        {
267
284
        }
268
285
 
269
286
        /**
270
 
         * Rollback the transaction early
 
287
         * Rollback the transaction. Note that this is done automatically in the
 
288
         * destructor if the transaction hasn't otherwise been completed.
271
289
         */
272
290
        void rollback()
273
291
        {