context classes, runtime classes, and related infrastructure

refs #81

src/blackcore/context_settings_interface.h

@@ -0,0 +1,136 @@
+/* Copyright (C) 2013 VATSIM Community / authors
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef BLACKCORE_CONTEXTSETTINGS_INTERFACE_H
+#define BLACKCORE_CONTEXTSETTINGS_INTERFACE_H
+
+#include "blackmisc/statusmessages.h"
+#include "blackmisc/genericdbusinterface.h"
+#include "blackmisc/settingutilities.h"
+#include "blackmisc/setnetwork.h"
+#include <QObject>
+#include <QVariant>
+#include <QDBusAbstractInterface>
+
+#define BLACKCORE_CONTEXTSETTINGS_INTERFACENAME "blackcore.contextsettings"
+#define BLACKCORE_CONTEXTSETTINGS_SERVICEPATH "/settings"
+
+// SERVICENAME must contain at least one ".", otherwise generation fails
+// as this is interpreted in the way comain.somename
+
+namespace BlackCore
+{
+
+    /*!
+     * \brief The IContextSettings class
+     */
+    class IContextSettings : public QObject
+    {
+        Q_OBJECT
+        Q_CLASSINFO("D-Bus Interface", BLACKCORE_CONTEXTSETTINGS_INTERFACENAME)
+
+    public:
+
+        /*!
+         * \brief Service name
+         * \return
+         */
+        static const QString &InterfaceName()
+        {
+            static QString s(BLACKCORE_CONTEXTSETTINGS_INTERFACENAME);
+            return s;
+        }
+
+        /*!
+         * \brief Service path
+         * \return
+         */
+        static const QString &ServicePath()
+        {
+            static QString s(BLACKCORE_CONTEXTSETTINGS_SERVICEPATH);
+            return s;
+        }
+
+        /*!
+         * \brief Path
+         * \return
+         */
+        static const QString &PathNetworkSettings()
+        {
+            static QString s("network");
+            return s;
+        }
+
+        /*!
+         * \brief DBus version constructor
+         * \param serviceName
+         * \param connection
+         * \param parent
+         */
+        IContextSettings(const QString &serviceName, QDBusConnection &connection, QObject *parent = 0);
+
+        /*!
+         * Destructor
+         */
+        ~IContextSettings() {}
+
+    private:
+        BlackMisc::CGenericDBusInterface *m_dBusInterface;
+
+        /*!
+         * \brief Relay connection signals to local signals
+         * No idea why this has to be wired and is not done automatically
+         * \param connection
+         */
+        void relaySignals(const QString &serviceName, QDBusConnection &connection);
+
+    protected:
+        /*!
+         * \brief IContextSettings
+         * \param parent
+         */
+        IContextSettings(QObject *parent = 0) : QObject(parent), m_dBusInterface(0) {}
+
+    signals:
+
+        /*!
+         * \brief Settings have been changed
+         */
+        void changedNetworkSettings();
+
+    public slots:
+
+        /*!
+         * \brief Network settings
+         * \return
+         */
+        virtual BlackMisc::Settings::CSettingsNetwork getNetworkSettings() const;
+
+        /*!
+         * \brief Handle value
+         * \param path
+         * \param command
+         * \param value
+         * \return
+         */
+        virtual BlackMisc::CStatusMessages value(const QString &path, const QString &command, const QVariant &value);
+
+        /*!
+         * Basically an unwanted signature as this is different from the "local" signature and
+         * contains explicit DBus types (a: QDbusArgument, b: type for conversion).
+         * If this can be removed, fine.
+         *
+         * \brief value
+         * \param path
+         * \param command
+         * \param value
+         * \param unifiedBlackMetaType
+         * \return
+         */
+        virtual BlackMisc::CStatusMessages value(const QString &path, const QString &command, QDBusVariant value, int unifiedBlackMetaType);
+    };
+}
+
+#endif // guard