X-Git-Url: https://git.quassel-irc.org/?p=quassel.git;a=blobdiff_plain;f=src%2Fcommon%2Fsettings.h;h=ed815dc472ff4649d5fb14137ea93842f6de3717;hp=efa03d7a2ab7d68850f0dd18c311bea713b2bb0f;hb=cc6e7c08709c4e761e2fd9c2e322751015497003;hpb=44b22c4419f478a20f6324f9f3a700a2dec56302 diff --git a/src/common/settings.h b/src/common/settings.h index efa03d7a..ed815dc4 100644 --- a/src/common/settings.h +++ b/src/common/settings.h @@ -1,11 +1,11 @@ /*************************************************************************** - * Copyright (C) 2005-07 by The Quassel Team * + * Copyright (C) 2005-2019 by the Quassel Project * * devel@quassel-irc.org * * * * This program is free software; you can redistribute it and/or modify * * it under the terms of the GNU General Public License as published by * * the Free Software Foundation; either version 2 of the License, or * - * (at your option) any later version. * + * (at your option) version 3. * * * * This program is distributed in the hope that it will be useful, * * but WITHOUT ANY WARRANTY; without even the implied warranty of * @@ -15,45 +15,188 @@ * 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. * ***************************************************************************/ -#ifndef _SETTINGS_H_ -#define _SETTINGS_H_ +#pragma once +#include "common-export.h" + +#include +#include +#include + +#include +#include +#include #include #include -class Settings : public QObject { - Q_OBJECT +#include "quassel.h" + +class COMMON_EXPORT SettingsChangeNotifier : public QObject +{ + Q_OBJECT + +signals: + void valueChanged(const QVariant& newValue); + +private: + friend class Settings; +}; + +class COMMON_EXPORT Settings +{ +public: + enum Mode + { + Default, + Custom + }; + +public: + //! Calls the given slot on change of the given key + template + void notify(const QString& key, const Receiver* receiver, Slot slot) const + { + static_assert(!std::is_same::value, "Old-style slots not supported"); + QObject::connect(notifier(normalizedKey(_group, keyForNotify(key))), &SettingsChangeNotifier::valueChanged, receiver, slot); + } + + //! Sets up notification and calls the given slot to set the initial value + template + void initAndNotify(const QString& key, const Receiver* receiver, Slot slot, const QVariant& defaultValue = {}) const + { + notify(key, receiver, std::move(slot)); + auto notifyKey = keyForNotify(key); + emit notifier(normalizedKey(_group, notifyKey))->valueChanged(localValue(notifyKey, defaultValue)); + } + + /** + * Get the major configuration version + * + * This indicates the backwards/forwards incompatible version of configuration. + * + * @return Major configuration version (the X in XX.YY) + */ + virtual uint version() const; + + /** + * Get the minor configuration version + * + * This indicates the backwards/forwards compatible version of configuration. + * + * @see Settings::setVersionMinor() + * @return Minor configuration version (the Y in XX.YY) + */ + virtual uint versionMinor() const; + + /** + * Set the minor configuration version + * + * When making backwards/forwards compatible changes, call this with the new version number. + * This does not implement any upgrade logic; implement that when checking Settings::version(), + * e.g. in Core::Core() and QtUiApplication::init(). + * + * @param[in] versionMinor New minor version number + */ + virtual void setVersionMinor(const uint versionMinor); + + /** + * Persist unsaved changes to permanent storage + * + * @return true if succeeded, false otherwise + */ + bool sync(); - public: - virtual ~Settings(); + /** + * Check if the configuration storage is writable. + * + * @return true if writable, false otherwise + */ + bool isWritable() const; - static void setGuiValue(QString, QVariant) {}; - static QVariant guiValue(QString, QVariant = QVariant()) { return QVariant(); } - protected: - Settings(QString group = "General"); +protected: + Settings(QString group, QString appName); + virtual ~Settings() = default; void setGroup(QString group); - virtual QStringList allLocalKeys(); - virtual QStringList localChildKeys(); - virtual QStringList localChildGroups(); - //virtual QStringList allSessionKeys() = 0; - virtual QStringList sessionKeys() = 0; + /** + * Allows subclasses to transform the key given to notify(). + * + * Default implementation just returns the given key. + * + * @param key Key given to notify() + * @returns Key that should be used for notfication + */ + virtual QString keyForNotify(const QString& key) const; - virtual void setLocalValue(const QString &key, const QVariant &data); - virtual QVariant localValue(const QString &key, const QVariant &def = QVariant()); + virtual QStringList allLocalKeys() const; + virtual QStringList localChildKeys(const QString& rootkey = QString()) const; + virtual QStringList localChildGroups(const QString& rootkey = QString()) const; - virtual void setSessionValue(const QString &key, const QVariant &data) = 0; - virtual QVariant sessionValue(const QString &key, const QVariant &def = QVariant()) = 0; + virtual void setLocalValue(const QString& key, const QVariant& data); + virtual QVariant localValue(const QString& key, const QVariant& def = QVariant()) const; - virtual void removeLocalKey(const QString &key); + /** + * Gets if a key exists in settings + * + * @param[in] key ID of local settings key + * @returns True if key exists in settings, otherwise false + */ + virtual bool localKeyExists(const QString& key) const; - QString group; -}; + virtual void removeLocalKey(const QString& key); + + QString _group; + QString _appName; + +private: + QSettings::Format format() const; + + QString fileName() const; + + QString normalizedKey(const QString& group, const QString& key) const; + + /** + * Update the cache of whether or not a given settings key persists on disk + * + * @param normKey Normalized settings key ID + * @param exists True if key exists, otherwise false + */ + void setCacheKeyPersisted(const QString& normKey, bool exists) const; + /** + * Check if the given settings key ID persists on disk (rather than being a default value) + * + * @see Settings::localKeyExists() + * + * @param normKey Normalized settings key ID + * @return True if key exists and persistence has been cached, otherwise false + */ + bool cacheKeyPersisted(const QString& normKey) const; + /** + * Check if the persistence of the given settings key ID has been cached + * + * @param normKey Normalized settings key ID + * @return True if key persistence has been cached, otherwise false + */ + bool isKeyPersistedCached(const QString& normKey) const; -#endif + void setCacheValue(const QString& normKey, const QVariant& data) const; + + QVariant cacheValue(const QString& normKey) const; + + bool isCached(const QString& normKey) const; + + SettingsChangeNotifier* notifier(const QString& normKey) const; + + bool hasNotifier(const QString& normKey) const; + +private: + static QHash _settingsCache; ///< Cached settings values + static QHash _settingsKeyPersistedCache; ///< Cached settings key exists on disk + static QHash> _settingsChangeNotifier; +};