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
|
/*
Copyright (c) 2009 Sascha Peilicke <sasch.pe@gmx.de>
This application is free software; you can redistribute it and/or modify it
under the terms of the GNU Library General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This application 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 Library General Public
License for more details.
You should have received a copy of the GNU Library General Public License
along with this application; see the file COPYING.LIB. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA.
*/
#ifndef AKONADISYNCSOURCE_H
#define AKONADISYNCSOURCE_H
#include "config.h"
#ifdef ENABLE_AKONADI
#include <Akonadi/Collection>
#include <Akonadi/Item>
#include <QtCore/QDateTime>
#include <QtCore/QStringList>
#include <syncevo/TrackingSyncSource.h>
SE_BEGIN_CXX
class TimeTrackingObserver;
/**
* General purpose Akonadi Sync Source. Choosing the type of data is
* done when instantiating it, using the Akonadi MIME subtypes.
* Payload is always using the native Akonadi format (no special "raw"
* and "engine" formats).
*
* Change tracking is done via the item uid/revision attributes.
*
* Databases (collections in Akonadi terminology) are selected via
* their int64 ID number.
*/
class AkonadiSyncSource : public TrackingSyncSource
{
public:
/**
* @param submime the MIME type string used by Akonadi
* to identify contacts, tasks, events, etc.
* @param params the SyncEvolution source parameters
*/
AkonadiSyncSource(const char *submime,
const SyncSourceParams ¶ms);
virtual ~AkonadiSyncSource();
/* methods that have to be implemented to complete TrackingSyncSource */
virtual Databases getDatabases();
virtual void open();
virtual void listAllItems(SyncSourceRevisions::RevisionMap_t &revisions);
virtual InsertItemResult insertItem(const std::string &luid, const std::string &item, bool raw);
virtual void readItem(const std::string &luid, std::string &item, bool raw);
virtual void removeItem(const string &luid);
virtual void close();
virtual bool isEmpty();
private:
void start();
protected:
Akonadi::Collection m_collection;
const std::string m_subMime;
};
class AkonadiContactSource : public AkonadiSyncSource
{
public:
AkonadiContactSource(const SyncSourceParams ¶ms)
: AkonadiSyncSource("text/directory", params)
{
}
virtual std::string getMimeType() const {
return "text/vcard";
}
virtual std::string getMimeVersion() const {
return "3.0";
}
void getSynthesisInfo(SynthesisInfo &info,
XMLConfigFragments &fragments)
{
TrackingSyncSource::getSynthesisInfo(info, fragments);
/** enable the KDE X- extensions in the Synthesis<->backend conversion */
info.m_backendRule = "KDE";
/*
* Disable the default VCARD_BEFOREWRITE_SCRIPT_EVOLUTION.
* If any KDE-specific transformations via such a script
* are needed, it can be named here and then defined by appending
* to the fragments.
*/
info.m_beforeWriteScript = ""; // "$VCARD_BEFOREWRITE_SCRIPT_KDE;";
// fragments.m_datatypes["VCARD_BEFOREWRITE_SCRIPT_KDE"] = "<macro name=\"VCARD_BEFOREWRITE_SCRIPT_KDE\"><![DATA[ ... ]]></macro>";
}
};
class AkonadiCalendarSource : public AkonadiSyncSource
{
public:
AkonadiCalendarSource(const SyncSourceParams ¶ms)
: AkonadiSyncSource("application/x-vnd.akonadi.calendar.event", params)
{
}
// TODO: the items are expected to be complete VCALENDAR with
// all necessary VTIMEZONEs and one VEVENT (here) resp. VTODO
// (AkonadiTodoSource). Not sure what we get from Akonadi.
virtual std::string getMimeType() const { return "text/calendar"; }
virtual std::string getMimeVersion() const { return "2.0"; }
};
class AkonadiTaskSource : public AkonadiSyncSource
{
public:
AkonadiTaskSource(const SyncSourceParams ¶ms)
: AkonadiSyncSource("text/calendar", params)
{
}
virtual std::string getMimeType() const { return "text/calendar"; }
virtual std::string getMimeVersion() const { return "2.0"; }
};
class AkonadiMemoSource : public AkonadiSyncSource
{
private:
QString toKJots(QString data);
QString toSynthesis(QString data);
public:
AkonadiMemoSource(const SyncSourceParams ¶ms)
: AkonadiSyncSource("text/x-vnd.akonadi.note", params)
{
}
// TODO: the AkonadiMemoSource is expected to import/export
// plain text with the summary in the first line; currently
// the AkonadiSyncSource will use VJOURNAL
// Also Currently there is no application which uses akonadi backend
// to display notes: probably work for knote??
virtual std::string getMimeType() const { return "text/plain"; }
virtual std::string getMimeVersion() const { return "1.0"; }
virtual InsertItemResult insertItem(const std::string &luid, const std::string &item, bool raw);
virtual void readItem(const std::string &luid, std::string &item, bool raw);
};
SE_END_CXX
#endif // ENABLE_AKONADI
#endif // AKONADISYNCSOURCE_H
|
