QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgstransaction.h
Go to the documentation of this file.
1/***************************************************************************
2 qgstransaction.h
3 ----------------
4 begin : May 5, 2014
5 copyright : (C) 2014 by Marco Hugentobler
6 email : marco dot hugentobler at sourcepole dot ch
7 ***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
18#ifndef QGSTRANSACTION_H
19#define QGSTRANSACTION_H
20
21#include <QSet>
22#include "qgis_sip.h"
23#include <QString>
24#include <QObject>
25#include <QStack>
26
27#include "qgis_core.h"
28#include "qgis_sip.h"
29
31class QgsVectorLayer;
32
56class CORE_EXPORT QgsTransaction : public QObject SIP_ABSTRACT
57{
58 Q_OBJECT
59
60 public:
61
66 static QgsTransaction *create( const QString &connString, const QString &providerKey ) SIP_FACTORY;
67
73 static QgsTransaction *create( const QSet<QgsVectorLayer *> &layers ) SIP_FACTORY;
74
75 ~QgsTransaction() override;
76
81 QString connectionString() const;
82
90 bool addLayer( QgsVectorLayer *layer, bool addLayersInEditMode = false );
91
102 bool begin( QString &errorMsg SIP_OUT, int statementTimeout = 20 );
103
107 bool commit( QString &errorMsg SIP_OUT );
108
112 bool rollback( QString &errorMsg SIP_OUT );
113
124 virtual bool executeSql( const QString &sql, QString &error SIP_OUT, bool isDirty = false, const QString &name = QString() ) = 0;
125
129 static bool supportsTransaction( const QgsVectorLayer *layer );
130
136 QString createSavepoint( QString &error SIP_OUT );
137
142 virtual QString createSavepoint( const QString &savePointId, QString &error SIP_OUT );
143
147 virtual bool rollbackToSavepoint( const QString &name, QString &error SIP_OUT );
148
152 void dirtyLastSavePoint();
153
157 QList< QString > savePoints() const { return QList< QString >::fromVector( mSavepoints ); }
158
162 bool lastSavePointIsDirty() const { return mLastSavePointIsDirty; }
163
165 // For internal use only, or by QgsTransactionGroup
166 static QString connectionString( const QString &layerUri ) SIP_SKIP;
168
169 signals:
170
175
179 void dirtied( const QString &sql, const QString &name );
180
181 protected:
182 QgsTransaction( const QString &connString ) SIP_SKIP;
183
184 QString mConnString;
186 QStack< QString > mSavepoints;
188
189 private slots:
190 void onLayerDeleted();
191
192 private:
193
194 QSet<QgsVectorLayer *> mLayers;
195
196 void setLayerTransactionIds( QgsTransaction *transaction );
197
198 static QString cleanupConnectionString( const QString &str );
199
200 virtual bool beginTransaction( QString &error, int statementTimeout ) = 0;
201 virtual bool commitTransaction( QString &error ) = 0;
202 virtual bool rollbackTransaction( QString &error ) = 0;
203};
204
205#endif // QGSTRANSACTION_H
This class allows including a set of layers in a database-side transaction, provided the layer data p...
QStack< QString > mSavepoints
bool mLastSavePointIsDirty
void afterRollback()
Emitted after a rollback.
QList< QString > savePoints() const
returns savepoints
virtual bool executeSql(const QString &sql, QString &error, bool isDirty=false, const QString &name=QString())=0
Execute the sql string.
bool lastSavePointIsDirty() const
returns the last created savepoint
void dirtied(const QString &sql, const QString &name)
Emitted if a sql query is executed and the underlying data is modified.
This is the base class for vector data providers.
Represents a vector layer which manages a vector based data sets.
#define str(x)
Definition: qgis.cpp:38
#define SIP_SKIP
Definition: qgis_sip.h:126
#define SIP_OUT
Definition: qgis_sip.h:58
#define SIP_ABSTRACT
Definition: qgis_sip.h:213
#define SIP_FACTORY
Definition: qgis_sip.h:76