Buteo Synchronization Framework
PluginManager.h
1/*
2 * This file is part of buteo-syncfw package
3 *
4 * Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
5 * Copyright (C) 2014-2021 Jolla Ltd.
6 *
7 * Contact: Sateesh Kavuri <sateesh.kavuri@nokia.com>
8 *
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public License
11 * version 2.1 as published by the Free Software Foundation.
12 *
13 * This library is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
17 *
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
21 * 02110-1301 USA
22 *
23 */
24#ifndef PLUGINMANAGER_H
25#define PLUGINMANAGER_H
26
27#include <QString>
28#include <QMap>
29#include <QReadWriteLock>
30#include <QProcess>
31#include <QPointer>
32
33class QPluginLoader;
34class QProcess;
35
36namespace Buteo {
37
39class StoragePlugin;
40class ClientPlugin;
41class ServerPlugin;
43class SyncProfile;
44class Profile;
45
46class ClientPluginTest;
47class ServerPluginTest;
48class StoragePluginTest;
49
55class PluginManager : public QObject
56{
57 Q_OBJECT
58
59public:
60 PluginManager();
65 PluginManager(const QString &aPluginPath);
66
71
77 StorageChangeNotifierPlugin *createStorageChangeNotifier(const QString &aStorageName);
78
84
90 StoragePlugin *createStorage(const QString &aPluginName);
91
96 void destroyStorage(StoragePlugin *aPlugin);
97
105 ClientPlugin *createClient(const QString &aPluginName,
106 const SyncProfile &aProfile,
107 PluginCbInterface *aCbInterface);
108
113 void destroyClient(ClientPlugin *aPlugin);
114
122 ServerPlugin *createServer(const QString &aPluginName,
123 const Profile &aProfile,
124 PluginCbInterface *aCbInterface);
125
130 void destroyServer(ServerPlugin *aPlugin);
131
132protected slots:
133 void onProcessFinished(int exitCode, QProcess::ExitStatus exitStatus);
134
135private:
136 class DllInfo
137 {
138 public:
139 void cleanUp();
140
141 QString iPath;
142 QProcess *iHandle = nullptr;
143 QPluginLoader *iPluginLoader = nullptr;
144 QPointer<QObject> iLoadedPlugin;
145 int iRefCount = 0;
146 };
147
148 void loadPluginMaps(const QString &pluginDirPath, const QString &aFilter, QMap<QString, QString> &aTargetMap);
149
150 QProcess *startOOPPlugin(const QString &aPluginName, const QString &aProfileName, const QString &aPluginFilePath);
151
152 void stopOOPPlugin(const QString &aPath);
153
154 void addLoadedPlugin(const QString &libraryName,
155 QPluginLoader *pluginLoader,
156 QObject *plugin);
157 QObject *acquireLoadedPlugin(const QString &libraryName);
158 void unloadPlugin(const QString &libraryName);
159
160 QString iPluginPath;
161
162 QMap<QString, QString> iStorageChangeNotifierMaps;
163 QMap<QString, QString> iStorageMaps;
164 QMap<QString, QString> iClientMaps;
165 QMap<QString, QString> iServerMaps;
166
167 QMap<QString, QString> iOopClientMaps;
168 QMap<QString, QString> iOoPServerMaps;
169
170 QList<DllInfo> iLoadedDlls;
171
172 QReadWriteLock iDllLock;
173
174 QString iProcBinaryPath;
175
176#ifdef SYNCFW_UNIT_TESTS
177 friend class ClientPluginTest;
178 friend class ServerPluginTest;
179 friend class StoragePluginTest;
180#endif
181
182};
183
184}
185
186#endif
Base class for client plugins.
Definition ClientPlugin.h:38
Interface which client and server plugins can use to communicate with synchronization daemon.
Definition PluginCbInterface.h:39
StoragePlugin * createStorage(const QString &aPluginName)
Creates a new storage plugin instance.
Definition PluginManager.cpp:171
ServerPlugin * createServer(const QString &aPluginName, const Profile &aProfile, PluginCbInterface *aCbInterface)
Creates a new server plugin instance.
Definition PluginManager.cpp:294
void destroyServer(ServerPlugin *aPlugin)
Destroys a server plugin.
Definition PluginManager.cpp:347
void destroyStorage(StoragePlugin *aPlugin)
Destroys a storage plugin instance.
Definition PluginManager.cpp:202
ClientPlugin * createClient(const QString &aPluginName, const SyncProfile &aProfile, PluginCbInterface *aCbInterface)
Creates a new client plugin instance.
Definition PluginManager.cpp:219
void destroyStorageChangeNotifier(StorageChangeNotifierPlugin *aPlugin)
Destroys a storage change notifier plugin instance.
Definition PluginManager.cpp:154
StorageChangeNotifierPlugin * createStorageChangeNotifier(const QString &aStorageName)
Creates a new storage change notifier plugin for the storage aStoragName.
Definition PluginManager.cpp:122
void destroyClient(ClientPlugin *aPlugin)
Destroys a client plugin instance.
Definition PluginManager.cpp:268
~PluginManager()
Destructor.
Definition PluginManager.cpp:113
This class represents a single profile, a collection of settings or data releated to some entity.
Definition Profile.h:53
Base class for server plugins.
Definition ServerPlugin.h:37
Implement this class to notify about changes in a specific storage - contacts/calendar/sms,...
Definition StorageChangeNotifierPlugin.h:15
Base class for storage plugins.
Definition StoragePlugin.h:39
A top level synchronization profile.
Definition SyncProfile.h:49
Definition SyncBackupAdaptor.h:40
Definition SyncBackupAdaptor.h:41