2018-12-27 23:11:32 +01:00
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <utils/Logger.h>
|
|
|
|
#include <utils/settings.h>
|
|
|
|
|
2020-11-14 17:58:56 +01:00
|
|
|
// qt includes
|
2018-12-27 23:11:32 +01:00
|
|
|
#include <QJsonObject>
|
|
|
|
|
|
|
|
class Hyperion;
|
2019-07-12 16:54:26 +02:00
|
|
|
class SettingsTable;
|
2018-12-27 23:11:32 +01:00
|
|
|
|
|
|
|
///
|
2020-11-14 17:58:56 +01:00
|
|
|
/// @brief Manage the settings read write from/to configuration file, on settings changed will emit a signal to update components accordingly
|
2018-12-27 23:11:32 +01:00
|
|
|
///
|
|
|
|
class SettingsManager : public QObject
|
|
|
|
{
|
|
|
|
Q_OBJECT
|
|
|
|
public:
|
|
|
|
///
|
|
|
|
/// @brief Construct a settings manager and assign a hyperion instance
|
2019-07-14 22:43:22 +02:00
|
|
|
/// @params instance Instance index of HyperionInstanceManager
|
|
|
|
/// @params parent The parent hyperion instance
|
2018-12-27 23:11:32 +01:00
|
|
|
///
|
2020-11-01 19:47:30 +01:00
|
|
|
SettingsManager(quint8 instance, QObject* parent = nullptr, bool readonlyMode = false);
|
2018-12-27 23:11:32 +01:00
|
|
|
|
|
|
|
///
|
2020-11-14 17:58:56 +01:00
|
|
|
/// @brief Save a complete json configuration
|
2018-12-27 23:11:32 +01:00
|
|
|
/// @param config The entire config object
|
|
|
|
/// @param correct If true will correct json against schema before save
|
2019-07-12 16:54:26 +02:00
|
|
|
/// @return True on success else false
|
2018-12-27 23:11:32 +01:00
|
|
|
///
|
2020-08-08 13:09:15 +02:00
|
|
|
bool saveSettings(QJsonObject config, bool correct = false);
|
2018-12-27 23:11:32 +01:00
|
|
|
|
|
|
|
///
|
2020-11-14 17:58:56 +01:00
|
|
|
/// @brief get a single setting json from configuration
|
2019-07-12 16:54:26 +02:00
|
|
|
/// @param type The settings::type from enum
|
|
|
|
/// @return The requested json data as QJsonDocument
|
2018-12-27 23:11:32 +01:00
|
|
|
///
|
2020-08-08 13:09:15 +02:00
|
|
|
QJsonDocument getSetting(settings::type type) const;
|
2018-12-27 23:11:32 +01:00
|
|
|
|
|
|
|
///
|
|
|
|
/// @brief get the full settings object of this instance (with global settings)
|
2019-07-12 16:54:26 +02:00
|
|
|
/// @return The requested json
|
2018-12-27 23:11:32 +01:00
|
|
|
///
|
2021-02-11 19:45:22 +01:00
|
|
|
QJsonObject getSettings() const;
|
2018-12-27 23:11:32 +01:00
|
|
|
|
|
|
|
signals:
|
|
|
|
///
|
2020-11-14 17:58:56 +01:00
|
|
|
/// @brief Emits whenever a configuration part changed.
|
2019-07-12 16:54:26 +02:00
|
|
|
/// @param type The settings type from enum
|
|
|
|
/// @param data The data as QJsonDocument
|
2018-12-27 23:11:32 +01:00
|
|
|
///
|
2020-08-08 13:09:15 +02:00
|
|
|
void settingsChanged(settings::type type, const QJsonDocument& data);
|
2018-12-27 23:11:32 +01:00
|
|
|
|
|
|
|
private:
|
2020-02-26 18:54:56 +01:00
|
|
|
///
|
2020-11-14 17:58:56 +01:00
|
|
|
/// @brief Add possible migrations steps for configuration here
|
2020-02-26 18:54:56 +01:00
|
|
|
/// @param config The configuration object
|
|
|
|
/// @return True when a migration has been triggered
|
|
|
|
///
|
|
|
|
bool handleConfigUpgrade(QJsonObject& config);
|
|
|
|
|
|
|
|
|
2018-12-27 23:11:32 +01:00
|
|
|
/// Hyperion instance
|
|
|
|
Hyperion* _hyperion;
|
2018-12-31 15:48:29 +01:00
|
|
|
|
2018-12-27 23:11:32 +01:00
|
|
|
/// Logger instance
|
|
|
|
Logger* _log;
|
2018-12-31 15:48:29 +01:00
|
|
|
|
2019-07-12 16:54:26 +02:00
|
|
|
/// instance of database table interface
|
|
|
|
SettingsTable* _sTable;
|
|
|
|
|
2018-12-27 23:11:32 +01:00
|
|
|
/// the schema
|
|
|
|
static QJsonObject schemaJson;
|
2018-12-31 15:48:29 +01:00
|
|
|
|
2020-11-14 17:58:56 +01:00
|
|
|
/// the current configuration of this instance
|
2018-12-27 23:11:32 +01:00
|
|
|
QJsonObject _qconfig;
|
2020-11-01 19:47:30 +01:00
|
|
|
|
|
|
|
bool _readonlyMode;
|
2018-12-27 23:11:32 +01:00
|
|
|
};
|