basepersonsdatasource.h

/*
    SPDX-FileCopyrightText: 2013 Martin Klapetek <[email protected]>
    SPDX-FileCopyrightText: 2013 David Edmundson <[email protected]>

    SPDX-License-Identifier: LGPL-2.1-or-later
*/

#ifndef BASE_PERSONS_DATA_SOURCE_H
#define BASE_PERSONS_DATA_SOURCE_H

#include <QObject>
#include <QVariant>

#include <kpeoplebackend/kpeoplebackend_export.h>

#include "allcontactsmonitor.h"
#include "contactmonitor.h"

namespace KPeople
{
class BasePersonsDataSourcePrivate;

// This is a QObject for KPluginFactory
class KPEOPLEBACKEND_EXPORT BasePersonsDataSource : public QObject
{
    Q_OBJECT
public:
    BasePersonsDataSource(QObject *parent, const QVariantList &args = QVariantList());
    ~BasePersonsDataSource() override;

    /**
     * Return a ref counted AllContactMonitor which lists and monitors all contacts from a source
     */
    AllContactsMonitorPtr allContactsMonitor();

    /**
     * Return a ref counted watcher for a single contact
     */
    ContactMonitorPtr contactMonitor(const QString &contactUri);

    /**
     * Returns the ID used by this datasource.
     * i.e if the contactIDs are in the form akonadi://?item=324 this method should return "akonadi"
     */
    virtual QString sourcePluginId() const = 0;

protected:
    virtual AllContactsMonitor *createAllContactsMonitor() = 0;

    /**
     * Base classes can implement this in order to not load every contact
     * otherwise the AllContactWatcher will be used and filtered.
     */
    virtual ContactMonitor *createContactMonitor(const QString &contactUri);

private:
    Q_DISABLE_COPY(BasePersonsDataSource)
    Q_DECLARE_PRIVATE(BasePersonsDataSource)
    BasePersonsDataSourcePrivate *d_ptr;
};

class KPEOPLEBACKEND_EXPORT BasePersonsDataSourceV2 : public BasePersonsDataSource
{
    Q_OBJECT
public:
    BasePersonsDataSourceV2(QObject *parent, const QVariantList &args = QVariantList());

    virtual bool addContact(const QVariantMap &properties) = 0;
    virtual bool deleteContact(const QString &uri) = 0;
};

}
#endif // BASE_PERSONS_DATA_SOURCE_H