/***************************************************************************
- * Copyright (C) 2005-08 by the Quassel Project *
+ * Copyright (C) 2005-2016 by the Quassel Project *
* devel@quassel-irc.org *
* *
* This program is free software; you can redistribute it and/or modify *
* You should have received a copy of the GNU General Public License *
* along with this program; if not, write to the *
* Free Software Foundation, Inc., *
- * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
***************************************************************************/
-#include <QSettings>
#include <QStringList>
-#include <QDebug>
-
-#ifdef Q_WS_QWS
-#include <Qtopia>
-#endif
#include "settings.h"
-QHash<QString, QHash<QString, QVariant> > Settings::settingsCache;
+const int VERSION = 1; /// Settings version for backwords/forwards incompatible changes
+
+// This is used if no VersionMinor key exists, e.g. upgrading from a Quassel version before this
+// change. This shouldn't be increased from 1; instead, change the logic in Core::Core() and
+// QtUiApplication::init() to handle upgrading and downgrading.
+const int VERSION_MINOR_INITIAL = 1; /// Initial settings version for compatible changes
+
+QHash<QString, QVariant> Settings::settingsCache;
+QHash<QString, SettingsChangeNotifier *> Settings::settingsChangeNotifier;
+
+#ifdef Q_OS_MAC
+# define create_qsettings QSettings s(QCoreApplication::organizationDomain(), appName)
+#else
+# define create_qsettings QSettings s(fileName(), format())
+#endif
// Settings::Settings(QString group_, QString appName_)
// : group(group_),
// */
// }
-QStringList Settings::allLocalKeys() {
- QSettings s(org(), appName);
- s.beginGroup(group);
- QStringList res = s.allKeys();
- s.endGroup();
- return res;
+void Settings::notify(const QString &key, QObject *receiver, const char *slot)
+{
+ QObject::connect(notifier(normalizedKey(group, key)), SIGNAL(valueChanged(const QVariant &)),
+ receiver, slot);
}
-QStringList Settings::localChildKeys(const QString &rootkey) {
- QString g;
- if(rootkey.isEmpty())
- g = group;
- else
- g = QString("%1/%2").arg(group, rootkey);
-
- QSettings s(org(), appName);
- s.beginGroup(g);
- QStringList res = s.childKeys();
- s.endGroup();
- return res;
+
+void Settings::initAndNotify(const QString &key, QObject *receiver, const char *slot, const QVariant &defaultValue)
+{
+ notify(key, receiver, slot);
+ emit notifier(normalizedKey(group, key))->valueChanged(localValue(key, defaultValue));
}
-QStringList Settings::localChildGroups(const QString &rootkey) {
- QString g;
- if(rootkey.isEmpty())
- g = group;
- else
- g = QString("%1/%2").arg(group, rootkey);
-
- QSettings s(org(), appName);
- s.beginGroup(g);
- QStringList res = s.childGroups();
- s.endGroup();
- return res;
+
+uint Settings::version()
+{
+ // we don't cache this value, and we ignore the group
+ create_qsettings;
+ uint ver = s.value("Config/Version", 0).toUInt();
+ if (!ver) {
+ // No version, so create one
+ s.setValue("Config/Version", VERSION);
+ return VERSION;
+ }
+ return ver;
}
-void Settings::setLocalValue(const QString &key, const QVariant &data) {
- QSettings s(org(), appName);
- s.beginGroup(group);
- s.setValue(key, data);
- s.endGroup();
- setCacheValue(group, key, data);
+
+uint Settings::versionMinor()
+{
+ // Don't cache this value; ignore the group
+ create_qsettings;
+ // '0' means new configuration, anything else indicates an existing configuration. Application
+ // initialization should check this value and manage upgrades/downgrades, e.g. in Core::Core()
+ // and QtUiApplication::init().
+ uint verMinor = s.value("Config/VersionMinor", 0).toUInt();
+
+ // As previous Quassel versions didn't implement this, we need to check if any settings other
+ // than Config/Version exist. If so, assume it's version 1.
+ if (verMinor == 0 && s.allKeys().count() > 1) {
+ // More than 1 key exists, but version's never been set. Assume and set version 1.
+ setVersionMinor(VERSION_MINOR_INITIAL);
+ return VERSION_MINOR_INITIAL;
+ } else {
+ return verMinor;
+ }
}
-const QVariant &Settings::localValue(const QString &key, const QVariant &def) {
- if(!isCached(group, key)) {
- QSettings s(org(), appName);
+
+void Settings::setVersionMinor(const uint versionMinor)
+{
+ // Don't cache this value; ignore the group
+ create_qsettings;
+ // Set the value directly.
+ s.setValue("Config/VersionMinor", versionMinor);
+}
+
+bool Settings::sync() {
+ create_qsettings;
+ s.sync();
+ switch (s.status()) {
+ case QSettings::NoError:
+ return true;
+ default:
+ return false;
+ }
+}
+
+bool Settings::isWritable() {
+ create_qsettings;
+ return s.isWritable();
+}
+
+QStringList Settings::allLocalKeys()
+{
+ create_qsettings;
s.beginGroup(group);
- setCacheValue(group, key, s.value(key, def));
+ QStringList res = s.allKeys();
s.endGroup();
- }
- return cacheValue(group, key);
+ return res;
}
-void Settings::removeLocalKey(const QString &key) {
- QSettings s(org(), appName);
- s.beginGroup(group);
- s.remove(key);
- s.endGroup();
- if(isCached(group, key))
- settingsCache[group].remove(key);
+
+QStringList Settings::localChildKeys(const QString &rootkey)
+{
+ QString g;
+ if (rootkey.isEmpty())
+ g = group;
+ else
+ g = QString("%1/%2").arg(group, rootkey);
+
+ create_qsettings;
+ s.beginGroup(g);
+ QStringList res = s.childKeys();
+ s.endGroup();
+ return res;
}
-// void Settings::setCacheValue(const QString &group, const QString &key, const QVariant &data) {
-// settingsCache[group][key] = data;
-// }
+QStringList Settings::localChildGroups(const QString &rootkey)
+{
+ QString g;
+ if (rootkey.isEmpty())
+ g = group;
+ else
+ g = QString("%1/%2").arg(group, rootkey);
-// const QVariant &Settings::cacheValue(const QString &group, const QString &key) {
-// return settingsCache[group][key];
-// }
+ create_qsettings;
+ s.beginGroup(g);
+ QStringList res = s.childGroups();
+ s.endGroup();
+ return res;
+}
-// bool Settings::isCached(const QString &group, const QString &key) {
-// return settingsCache.contains(group) && settingsCache[group].contains(key);
-// }
+
+void Settings::setLocalValue(const QString &key, const QVariant &data)
+{
+ QString normKey = normalizedKey(group, key);
+ create_qsettings;
+ s.setValue(normKey, data);
+ setCacheValue(normKey, data);
+ if (hasNotifier(normKey)) {
+ emit notifier(normKey)->valueChanged(data);
+ }
+}
+
+
+const QVariant &Settings::localValue(const QString &key, const QVariant &def)
+{
+ QString normKey = normalizedKey(group, key);
+ if (!isCached(normKey)) {
+ create_qsettings;
+ setCacheValue(normKey, s.value(normKey, def));
+ }
+ return cacheValue(normKey);
+}
+
+bool Settings::localKeyExists(const QString &key)
+{
+ QString normKey = normalizedKey(group, key);
+ if (isCached(normKey))
+ return true;
+
+ create_qsettings;
+ return s.contains(normKey);
+}
+
+
+void Settings::removeLocalKey(const QString &key)
+{
+ create_qsettings;
+ s.beginGroup(group);
+ s.remove(key);
+ s.endGroup();
+ QString normKey = normalizedKey(group, key);
+ if (isCached(normKey))
+ settingsCache.remove(normKey);
+}
projects / quassel.git / blobdiff