blob: f787a3eb02cc2cbd22e5ae2615b36f41fa748c2e (
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
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
|
/*
* Copyright (C) 2015 Christian Mollekopf <chrigi_1@fastmail.fm>
*
* 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 "sink_export.h"
#include <QString>
#include <QSharedPointer>
#include <Async/Async>
#include "query.h"
#include "applicationdomaintype.h"
class QAbstractItemModel;
namespace Sink {
/**
* The unified Sink Store.
*
* This is the primary interface for clients to interact with Sink.
* It provides a unified store where all data provided by various resources can be accessed and modified.
*/
namespace Store {
QString SINK_EXPORT storageLocation();
/**
* Returns a unique path for a writable file that can be used to write BLOB properties.
*/
QString SINK_EXPORT getTemporaryFilePath();
enum Roles
{
DomainObjectRole = Qt::UserRole + 1, // Must be the same as in ModelResult
ChildrenFetchedRole,
DomainObjectBaseRole
};
/**
* Asynchronusly load a dataset with tree structure information
*/
template <class DomainType>
QSharedPointer<QAbstractItemModel> SINK_EXPORT loadModel(const Query &query);
/**
* Create a new entity.
*/
template <class DomainType>
KAsync::Job<void> SINK_EXPORT create(const DomainType &domainObject);
/**
* Modify an entity.
*
* This includes moving etc. since these are also simple settings on a property.
*/
template <class DomainType>
KAsync::Job<void> SINK_EXPORT modify(const DomainType &domainObject);
/**
* Modify a set of entities identified by @param query.
*/
template <class DomainType>
KAsync::Job<void> SINK_EXPORT modify(const Query &query, const DomainType &domainObject);
/**
* Remove an entity.
*/
template <class DomainType>
KAsync::Job<void> SINK_EXPORT remove(const DomainType &domainObject);
/**
* Remove a set of entities identified by @param query.
*/
template <class DomainType>
KAsync::Job<void> SINK_EXPORT remove(const Query &query);
/**
* Move an entity to a new resource.
*/
template <class DomainType>
KAsync::Job<void> SINK_EXPORT move(const DomainType &domainObject, const QByteArray &newResource);
/**
* Copy an entity to a new resource.
*/
template <class DomainType>
KAsync::Job<void> SINK_EXPORT copy(const DomainType &domainObject, const QByteArray &newResource);
/**
* Synchronize data to local cache.
*/
KAsync::Job<void> SINK_EXPORT synchronize(const Sink::Query &query);
KAsync::Job<void> SINK_EXPORT synchronize(const Sink::SyncScope &query);
/**
* Removes all resource data from disk.
*
* This will not touch the configuration. All commands that that arrived at the resource before this command will be dropped. All commands that arrived later will be executed.
*/
KAsync::Job<void> SINK_EXPORT removeDataFromDisk(const QByteArray &resourceIdentifier);
template <class DomainType>
KAsync::Job<DomainType> SINK_EXPORT fetchOne(const Sink::Query &query);
template <class DomainType>
KAsync::Job<QList<typename DomainType::Ptr>> SINK_EXPORT fetchAll(const Sink::Query &query);
template <class DomainType>
KAsync::Job<QList<typename DomainType::Ptr>> SINK_EXPORT fetch(const Sink::Query &query, int minimumAmount = 0);
template <class DomainType>
DomainType SINK_EXPORT readOne(const Sink::Query &query);
template <class DomainType>
QList<DomainType> SINK_EXPORT read(const Sink::Query &query);
}
}
|
