settingsaccessor.h 5.5 KB
Newer Older
hjk's avatar
hjk committed
1
/****************************************************************************
2
**
3
** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
hjk's avatar
hjk committed
4
** Contact: http://www.qt-project.org/legal
5
**
hjk's avatar
hjk committed
6
** This file is part of Qt Creator.
7
**
hjk's avatar
hjk committed
8
9
10
11
12
13
14
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
15
16
**
** GNU Lesser General Public License Usage
hjk's avatar
hjk committed
17
18
19
20
21
22
23
24
25
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Digia gives you certain additional
** rights.  These rights are described in the Digia Qt LGPL Exception
con's avatar
con committed
26
27
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
hjk's avatar
hjk committed
28
****************************************************************************/
29

30
31
#ifndef SETTINGSACCESSOR_H
#define SETTINGSACCESSOR_H
32

33
#include <utils/fileutils.h>
34

35
#include <QHash>
36
#include <QVariantMap>
37
#include <QMessageBox>
38
39

namespace Utils { class PersistentSettingsWriter; }
40

41
42
43
44
namespace ProjectExplorer {

class Project;

45
namespace Internal { class VersionUpgrader; }
46

47
48
class SettingsAccessorPrivate;

49
class SettingsAccessor
50
51
{
public:
Tobias Hunger's avatar
Tobias Hunger committed
52
    SettingsAccessor(Project *project);
53
    virtual ~SettingsAccessor();
54

Tobias Hunger's avatar
Tobias Hunger committed
55
    Project *project() const;
56

57
    QVariantMap restoreSettings(QWidget *parent) const;
58
    bool saveSettings(const QVariantMap &data, QWidget *parent) const;
59

60
61
62
63
64
    static QVariantMap setVersionInMap(const QVariantMap &data, int version);
    static int versionFromMap(const QVariantMap &data);
    static int originalVersionFromMap(const QVariantMap &data);
    static QVariantMap setOriginalVersionInMap(const QVariantMap &data, int version);

65
66
67
68
    int currentVersion() const;
    int firstSupportedVersion() const;

    bool addVersionUpgrader(Internal::VersionUpgrader *upgrader); // takes ownership of upgrader
69

70
    enum ProceedInfo { Continue, DiscardAndContinue };
71
    typedef QHash<QMessageBox::StandardButton, ProceedInfo> ButtonMap;
72
73
74
75
76
77
    class IssueInfo {
    public:
        IssueInfo() : defaultButton(QMessageBox::NoButton), escapeButton(QMessageBox::NoButton) { }
        IssueInfo(const QString &t, const QString &m,
                  QMessageBox::StandardButton d = QMessageBox::NoButton,
                  QMessageBox::StandardButton e = QMessageBox::NoButton,
78
                  const ButtonMap &b = ButtonMap()) :
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
            title(t), message(m), defaultButton(d), escapeButton(e), buttons(b)
        { }
        IssueInfo(const IssueInfo &other) :
            title(other.title),
            message(other.message),
            defaultButton(other.defaultButton),
            escapeButton(other.escapeButton),
            buttons(other.buttons)
        { }

        IssueInfo &operator = (const IssueInfo &other)
        {
            title = other.title;
            message = other.message;
            defaultButton = other.defaultButton;
            escapeButton = other.escapeButton;
            buttons = other.buttons;
            return *this;
        }

        QString title;
        QString message;
        QMessageBox::StandardButton defaultButton;
        QMessageBox::StandardButton escapeButton;
        QHash<QMessageBox::StandardButton, ProceedInfo> buttons;
    };

106
107
108
protected:
    QVariantMap readFile(const Utils::FileName &path) const;
    QVariantMap upgradeSettings(const QVariantMap &data, int toVersion) const;
109
110
111

    ProceedInfo reportIssues(const QVariantMap &data, const Utils::FileName &path, QWidget *parent) const;

112
    virtual QVariantMap prepareSettings(const QVariantMap &data) const;
113
    virtual QVariantMap prepareToSaveSettings(const QVariantMap &data) const;
114

115
116
    virtual bool isBetterMatch(const QVariantMap &origData, const QVariantMap &newData) const;

117
118
    virtual Utils::FileName backupName(const QVariantMap &data) const;

119
120
    virtual IssueInfo findIssues(const QVariantMap &data, const Utils::FileName &path) const;

121
private:
122
    QList<Utils::FileName> settingsFiles(const QString &suffix) const;
123
    static QByteArray creatorId();
124
    QString defaultFileName(const QString &suffix) const;
125
    void backupUserFile() const;
126

127
128
129
    QVariantMap readUserSettings(QWidget *parent) const;
    QVariantMap readSharedSettings(QWidget *parent) const;
    QVariantMap mergeSettings(const QVariantMap &userMap, const QVariantMap &sharedMap) const;
130

131
    static QByteArray environmentIdFromMap(const QVariantMap &data);
132
    static QString differentEnvironmentMsg(const QString &projectName);
133

134
135
    QString m_userSuffix;
    QString m_sharedSuffix;
Tobias Hunger's avatar
Tobias Hunger committed
136
137

    Project *m_project;
138
139
140
141

    SettingsAccessorPrivate *d;

    friend class SettingsAccessorPrivate;
142
143
};

144
145
146
147
148
namespace Internal {
class UserFileAccessor : public SettingsAccessor
{
public:
    UserFileAccessor(Project *project);
149
150
151

protected:
    QVariantMap prepareSettings(const QVariantMap &data) const;
152
    QVariantMap prepareToSaveSettings(const QVariantMap &data) const;
153
154
155
};

} // namespace Internal
156
157
} // namespace ProjectExplorer

158
#endif // SETTINGSACCESSOR_H