File: deltasyncadapter.h

package info (click to toggle)
qtcontacts-sqlite 0.3.20-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 3,952 kB
  • sloc: cpp: 32,880; ansic: 1,269; xml: 62; makefile: 32; sh: 18
file content (109 lines) | stat: -rw-r--r-- 5,150 bytes parent folder | download | duplicates (2)
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
/*
 * Copyright (C) 2016 Jolla Ltd.
 * Contact: Chris Adams <chris.adams@jolla.com>
 *
 * You may use this file under the terms of the BSD license as follows:
 *
 * "Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 *   * Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 *   * Redistributions in binary form must reproduce the above copyright
 *     notice, this list of conditions and the following disclaimer in
 *     the documentation and/or other materials provided with the
 *     distribution.
 *   * Neither the name of Nemo Mobile nor the names of its contributors
 *     may be used to endorse or promote products derived from this
 *     software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
 */

#ifndef DELTASYNCADAPTER_H
#define DELTASYNCADAPTER_H

#include "../../../src/extensions/twowaycontactsyncadapter.h"
#include <QContactManager>
#include <QContact>
#include <QTimer>
#include <QDateTime>
#include <QList>
#include <QPair>
#include <QMap>

QTCONTACTS_USE_NAMESPACE

class DeltaSyncAdapter : public QObject, public QtContactsSqliteExtensions::TwoWayContactSyncAdapter
{
    Q_OBJECT

public:
    DeltaSyncAdapter(const QString &accountId, QObject *parent = 0);
    ~DeltaSyncAdapter();

    enum PhoneModifiability {
        ImplicitlyModifiable = 0,
        ExplicitlyModifiable,
        ExplicitlyNonModifiable
    };

    // for testing purposes
    void addRemoteContact(const QString &accountId, const QString &fname, const QString &lname, const QString &phone, PhoneModifiability mod = ImplicitlyModifiable);
    void removeRemoteContact(const QString &accountId, const QString &fname, const QString &lname);
    void setRemoteContact(const QString &accountId, const QString &fname, const QString &lname, const QContact &contact);
    void changeRemoteContactPhone(const QString &accountId, const QString &fname, const QString &lname, const QString &modPhone);
    void changeRemoteContactEmail(const QString &accountId, const QString &fname, const QString &lname, const QString &modEmail);
    void changeRemoteContactName(const QString &accountId, const QString &fname, const QString &lname, const QString &modfname, const QString &modlname);
    void addRemoteDuplicates(const QString &accountId, const QString &fname, const QString &lname, const QString &phone);
    void mergeRemoteDuplicates(const QString &accountId);

    // triggering sync and checking state.
    void performTwoWaySync(const QString &accountId);
    bool upsyncWasRequired(const QString &accountId) const;
    bool downsyncWasRequired(const QString &accountId) const;
    QContact remoteContact(const QString &accountId, const QString &fname, const QString &lname) const;
    QSet<QContactId> modifiedIds(const QString &accountId) const;

Q_SIGNALS:
    void finished();
    void failed();

protected:
    // implementing the TWCSA interface
    void determineRemoteChanges(const QDateTime &remoteSince,
                                const QString &accountId);

    bool testAccountProvenance(const QContact &contact, const QString &accountId);
    void upsyncLocalChanges(const QDateTime &localSince,
                            const QList<QContact> &locallyAdded,
                            const QList<QContact> &locallyModified,
                            const QList<QContact> &locallyDeleted,
                            const QString &accountId);

private:
    void cleanUp(const QString &accountId);
    QString m_accountId;
    // simulating server-side changes, per account:
    mutable QMap<QString, QTimer*> m_simulationTimers;
    mutable QMap<QString, bool> m_downsyncWasRequired;
    mutable QMap<QString, bool> m_upsyncWasRequired;
    mutable QMap<QString, QDateTime> m_remoteSince;
    mutable QMap<QString, QList<QContact> > m_remoteDeletions;
    mutable QMap<QString, QSet<QString> > m_remoteAddMods; // used to lookup into m_remoteServerContacts
    mutable QMap<QString, QMap<QString, QContact> > m_remoteServerContacts;
    mutable QMap<QString, QSet<QContactId> > m_modifiedIds;
    mutable QMap<QString, QMultiMap<QString, QString> > m_remoteServerDuplicates; // accountId to originalGuid to duplicateGuids.
};

#endif // DELTASYNCADAPTER_H