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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
/*
* Copyright (C) 2014 Christian Mollekopf <chrigi_1@fastmail.fm>
* Copyright (C) 2014 Aaron Seigo <aseigo@kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) version 3, or any
* later version accepted by the membership of KDE e.V. (or its
* successor approved by the membership of KDE e.V.), which shall
* act as a proxy defined in Section 6 of version 3 of the license.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#pragma once
#include <akonadi2common_export.h>
#include <string>
#include <functional>
#include <QString>
namespace Akonadi2
{
class AKONADI2COMMON_EXPORT Storage {
public:
enum AccessMode { ReadOnly, ReadWrite };
enum ErrorCodes {
GenericError,
NotOpen,
ReadOnlyError,
TransactionError,
NotFound
};
class Error
{
public:
Error(const QByteArray &s, int c, const QByteArray &m)
: store(s), message(m), code(c) {}
QByteArray store;
QByteArray message;
int code;
};
class Transaction;
class NamedDatabase
{
public:
NamedDatabase();
~NamedDatabase();
/**
* Write a value
*/
bool write(const QByteArray &key, const QByteArray &value, const std::function<void(const Storage::Error &error)> &errorHandler = std::function<void(const Storage::Error &error)>());
/**
* Remove a value
*/
void remove(const QByteArray &key,
const std::function<void(const Storage::Error &error)> &errorHandler = std::function<void(const Storage::Error &error)>());
/**
* Read values with a given key.
*
* * An empty @param key results in a full scan
* * If duplicates are existing (revisions), all values are returned.
* * The pointers of the returned values are valid during the execution of the @param resultHandler
*
* @return The number of values retrieved.
*/
int scan(const QByteArray &k,
const std::function<bool(const QByteArray &key, const QByteArray &value)> &resultHandler,
const std::function<void(const Storage::Error &error)> &errorHandler = std::function<void(const Storage::Error &error)>()) const;
NamedDatabase(NamedDatabase&& other) : d(other.d)
{
d = other.d;
other.d = nullptr;
}
NamedDatabase& operator=(NamedDatabase&& other) {
d = other.d;
other.d = nullptr;
return *this;
}
operator bool() const {
return (d != nullptr);
}
private:
friend Transaction;
NamedDatabase(NamedDatabase& other);
NamedDatabase& operator=(NamedDatabase& other);
class Private;
NamedDatabase(Private*);
Private *d;
};
class Transaction
{
public:
Transaction();
~Transaction();
bool commit(const std::function<void(const Storage::Error &error)> &errorHandler = std::function<void(const Storage::Error &error)>());
void abort();
NamedDatabase openDatabase(const QByteArray &name = QByteArray("default"), const std::function<void(const Storage::Error &error)> &errorHandler = std::function<void(const Storage::Error &error)>(), bool allowDuplicates = false) const;
Transaction(Transaction&& other) : d(other.d)
{
d = other.d;
other.d = nullptr;
}
Transaction& operator=(Transaction&& other) {
d = other.d;
other.d = nullptr;
return *this;
}
operator bool() const {
return (d != nullptr);
}
private:
Transaction(Transaction& other);
Transaction& operator=(Transaction& other);
friend Storage;
class Private;
Transaction(Private*);
Private *d;
};
Storage(const QString &storageRoot, const QString &name, AccessMode mode = ReadOnly);
~Storage();
Transaction createTransaction(AccessMode mode = ReadWrite,
const std::function<void(const Storage::Error &error)> &errorHandler = std::function<void(const Storage::Error &error)>());
/**
* Set the default error handler.
*/
void setDefaultErrorHandler(const std::function<void(const Storage::Error &error)> &errorHandler);
std::function<void(const Storage::Error &error)> defaultErrorHandler() const;
/**
* A basic error handler that writes to std::cerr.
*
* Used if nothing else is configured.
*/
static std::function<void(const Storage::Error &error)> basicErrorHandler();
qint64 diskUsage() const;
void removeFromDisk() const;
qint64 maxRevision();
void setMaxRevision(qint64 revision);
static qint64 maxRevision(const Akonadi2::Storage::Transaction &);
static void setMaxRevision(Akonadi2::Storage::Transaction &, qint64 revision);
bool exists() const;
static bool isInternalKey(const char *key);
static bool isInternalKey(void *key, int keySize);
static bool isInternalKey(const QByteArray &key);
private:
std::function<void(const Storage::Error &error)> mErrorHandler;
private:
class Private;
Private * const d;
};
} // namespace Akonadi2
|
