summaryrefslogtreecommitdiffstats
path: root/common/storage.h
blob: 6ae783841b919eb829053a55de440758c8cabf86 (plain)
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
/*
 * 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 };

    class Error
    {
    public:
        Error(const std::string &s, int c, const std::string &m)
            : store(s), message(m), code(c) {}
        std::string store;
        std::string message;
        int code;
    };

    Storage(const QString &storageRoot, const QString &name, AccessMode mode = ReadOnly);
    ~Storage();
    bool isInTransaction() const;
    bool startTransaction(AccessMode mode = ReadWrite);
    bool commitTransaction();
    void abortTransaction();
    //TODO: row removal
    //TODO: cursor based read
    //TODO: query?
    bool write(void const *key, size_t keySize, void const *value, size_t valueSize);
    bool write(const std::string &sKey, const std::string &sValue);
    void read(const std::string &sKey,
              const std::function<bool(const std::string &value)> &resultHandler);
    void read(const std::string &sKey,
              const std::function<bool(const std::string &value)> &resultHandler,
              const std::function<void(const Storage::Error &error)> &errorHandler);
    void read(const std::string &sKey, const std::function<bool(void *ptr, int size)> &resultHandler);
    void read(const std::string &sKey,
              const std::function<bool(void *ptr, int size)> & resultHandler,
              const std::function<void(const Storage::Error &error)> &errorHandler);
    void scan(const std::string &sKey, const std::function<bool(void *keyPtr, int keySize, void *valuePtr, int valueSize)> &resultHandler);
    void scan(const char *keyData, uint keySize,
              const std::function<bool(void *keyPtr, int keySize, void *ptr, int size)> &resultHandler,
              const std::function<void(const Storage::Error &error)> &errorHandler);

    static std::function<void(const Storage::Error &error)> basicErrorHandler();
    qint64 diskUsage() const;
    void removeFromDisk() const;

    qint64 maxRevision();
    void setMaxRevision(qint64 revision);

    bool exists() const;
private:
    class Private;
    Private * const d;
};

} // namespace Akonadi2