1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
/*
* Copyright 2008-2021 Fabrice Colin
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
#ifndef _SQL_DB_H
#define _SQL_DB_H
#include <string>
#include <vector>
#include <utility>
/// A row of results.
class SQLRow
{
public:
virtual ~SQLRow();
typedef enum { SQL_TYPE_INT = 0, SQL_TYPE_DOUBLE, SQL_TYPE_TIME, SQL_TYPE_DATE, SQL_TYPE_DATETIME, SQL_TYPE_TIMESTAMP, SQL_TYPE_STRING, SQL_TYPE_BLOB, SQL_TYPE_NULL } SQLType;
unsigned int getColumnsCount(void) const;
virtual std::string getColumn(unsigned int nColumn) const = 0;
protected:
unsigned int m_nColumns;
SQLRow(unsigned int nColumns);
private:
SQLRow(const SQLRow &other);
SQLRow &operator=(const SQLRow &other);
};
/// Results extracted from the database.
class SQLResults
{
public:
virtual ~SQLResults();
virtual bool hasMoreRows(void) const;
virtual std::string getColumnName(unsigned int nColumn) const = 0;
virtual SQLRow *nextRow(void) = 0;
virtual bool rewind(void);
protected:
unsigned long m_nRows;
unsigned int m_nColumns;
unsigned long int m_nCurrentRow;
SQLResults(unsigned long nRows, unsigned int nColumns);
private:
SQLResults(const SQLResults &other);
SQLResults &operator=(const SQLResults &other);
};
/// A SQL database.
class SQLDB
{
public:
virtual ~SQLDB();
virtual bool upgrade(unsigned int versionNum, const std::string &sql,
const std::string &sqlPostUpgrade);
virtual bool isReadOnly(void) const;
virtual bool isOpen(void) const = 0;
virtual bool alterTable(const std::string &tableName,
const std::string &columns,
const std::string &newDefinition) = 0;
virtual bool beginTransaction(void) = 0;
virtual bool rollbackTransaction(void) = 0;
virtual bool endTransaction(void) = 0;
virtual bool executeSimpleStatement(const std::string &sql) = 0;
virtual SQLResults *executeStatement(const char *sqlFormat, ...) = 0;
virtual bool prepareStatement(const std::string &statementId,
const std::string &sqlFormat) = 0;
virtual SQLResults *executePreparedStatement(const std::string &statementId,
const std::vector<std::string> &values) = 0;
virtual SQLResults *executePreparedStatement(const std::string &statementId,
const std::vector<std::pair<std::string, SQLRow::SQLType> > &values) = 0;
protected:
std::string m_databaseName;
bool m_readOnly;
SQLDB(const std::string &databaseName,
bool readOnly = false);
private:
SQLDB(const SQLDB &other);
SQLDB &operator=(const SQLDB &other);
};
#endif // _SQL_DB_H
|
