/***************************************************************************
- * Copyright (C) 2005-07 by the Quassel IRC Team *
+ * Copyright (C) 2005-2018 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 *
* 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. *
- ***************************************************************************
- * SignalProxy has been inspired by QxtRPCPeer, part of libqxt, *
- * the Qt eXTension Library <http://www.libqxt.org>. We would like to *
- * thank Arvid "aep" Picciani and Adam "ahigerd" Higerd for providing *
- * QxtRPCPeer, valuable input and the genius idea to (ab)use Qt's *
- * Meta Object System for transmitting signals over the network. *
- * *
- * To make contribution back into libqxt possible, redistribution and *
- * modification of this file is additionally allowed under the terms of *
- * the Common Public License, version 1.0, as published by IBM. *
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
***************************************************************************/
-#ifndef _SIGNALPROXY_H_
-#define _SIGNALPROXY_H_
+#pragma once
+
+#include "common-export.h"
+
+#include <functional>
+#include <initializer_list>
+
+#include <QEvent>
+#include <QSet>
-#include <QList>
-#include <QHash>
-#include <QVariant>
-#include <QPair>
-#include <QString>
-#include <QByteArray>
+#include "protocol.h"
-class SignalRelay;
+struct QMetaObject;
+class QIODevice;
-class SignalProxy : public QObject {
- Q_OBJECT
+class Peer;
+class SyncableObject;
+
+class COMMON_EXPORT SignalProxy : public QObject
+{
+ Q_OBJECT
+
+ class SignalRelay;
public:
- enum ProxyMode {
- Server,
- Client
- };
-
- SignalProxy(QObject* parent);
- SignalProxy(ProxyMode mode, QObject* parent);
- SignalProxy(ProxyMode mode, QIODevice* device, QObject* parent);
- virtual ~SignalProxy();
-
- void setProxyMode(ProxyMode mode);
- ProxyMode proxyMode() const;
-
- bool addPeer(QIODevice *iodev);
- void removePeer(QIODevice *iodev = 0);
-
- bool attachSignal(QObject* sender, const char* signal, const QByteArray& sigName = QByteArray());
- bool attachSlot(const QByteArray& sigName, QObject* recv, const char* slot);
-
- void detachObject(QObject *obj);
- void detachSignals(QObject *sender);
- void detachSlots(QObject *receiver);
-
- void call(const char *signal , QVariant p1, QVariant p2, QVariant p3, QVariant p4,
- QVariant p5, QVariant p6, QVariant p7, QVariant p8, QVariant p9);
- void call(const QByteArray &funcName, const QVariantList ¶ms);
-
- static void writeDataToDevice(QIODevice *dev, const QVariant &item);
- static bool readDataFromDevice(QIODevice *dev, quint32 &blockSize, QVariant &item);
-
- const QList<int> &argTypes(QObject* obj, int methodId);
- const QByteArray &methodName(QObject* obj, int methodId);
-
- typedef QHash<int, QList<int> > ArgHash;
- typedef QHash<int, QByteArray> MethodNameHash;
- struct ClassInfo {
- ArgHash argTypes;
- MethodNameHash methodNames;
- // QHash<int, int> syncMap
- };
-
- void dumpProxyStats();
-
+ enum ProxyMode
+ {
+ Server,
+ Client
+ };
+
+ enum EventType
+ {
+ RemovePeerEvent = QEvent::User
+ };
+
+ SignalProxy(QObject* parent);
+ SignalProxy(ProxyMode mode, QObject* parent);
+ ~SignalProxy() override;
+
+ void setProxyMode(ProxyMode mode);
+ inline ProxyMode proxyMode() const { return _proxyMode; }
+
+ void setHeartBeatInterval(int secs);
+ inline int heartBeatInterval() const { return _heartBeatInterval; }
+ void setMaxHeartBeatCount(int max);
+ inline int maxHeartBeatCount() const { return _maxHeartBeatCount; }
+
+ bool addPeer(Peer* peer);
+
+ bool attachSignal(QObject* sender, const char* signal, const QByteArray& sigName = QByteArray());
+ bool attachSlot(const QByteArray& sigName, QObject* recv, const char* slot);
+
+ void synchronize(SyncableObject* obj);
+ void stopSynchronize(SyncableObject* obj);
+
+ class ExtendedMetaObject;
+ ExtendedMetaObject* extendedMetaObject(const QMetaObject* meta) const;
+ ExtendedMetaObject* createExtendedMetaObject(const QMetaObject* meta, bool checkConflicts = false);
+ inline ExtendedMetaObject* extendedMetaObject(const QObject* obj) const { return extendedMetaObject(metaObject(obj)); }
+ inline ExtendedMetaObject* createExtendedMetaObject(const QObject* obj, bool checkConflicts = false)
+ {
+ return createExtendedMetaObject(metaObject(obj), checkConflicts);
+ }
+
+ bool isSecure() const { return _secure; }
+ void dumpProxyStats();
+ void dumpSyncMap(SyncableObject* object);
+
+ static SignalProxy* current();
+
+ /**@{*/
+ /**
+ * This method allows to send a signal only to a limited set of peers
+ * @param peers A list of peers that should receive it
+ * @param closure Code you want to execute within of that restricted environment
+ */
+ void restrictTargetPeers(QSet<Peer*> peers, std::function<void()> closure);
+ void restrictTargetPeers(Peer* peer, std::function<void()> closure)
+ {
+ QSet<Peer*> set;
+ set.insert(peer);
+ restrictTargetPeers(set, std::move(closure));
+ }
+
+ // A better version, but only implemented on Qt5 if Initializer Lists exist
+#ifdef Q_COMPILER_INITIALIZER_LISTS
+ void restrictTargetPeers(std::initializer_list<Peer*> peers, std::function<void()> closure)
+ {
+ restrictTargetPeers(QSet<Peer*>(peers), std::move(closure));
+ }
+#endif
+ /**}@*/
+
+ inline int peerCount() const { return _peerMap.size(); }
+ QVariantList peerData();
+
+ Peer* peerById(int peerId);
+
+ /**
+ * @return If handling a signal, the Peer from which the current signal originates
+ */
+ Peer* sourcePeer();
+ void setSourcePeer(Peer* sourcePeer);
+
+ /**
+ * @return If sending a signal, the Peer to which the current signal is directed
+ */
+ Peer* targetPeer();
+ void setTargetPeer(Peer* targetPeer);
+
+public slots:
+ void detachObject(QObject* obj);
+ void detachSignals(QObject* sender);
+ void detachSlots(QObject* receiver);
+
+protected:
+ void customEvent(QEvent* event) override;
+ void sync_call__(const SyncableObject* obj, ProxyMode modeType, const char* funcname, va_list ap);
+ void renameObject(const SyncableObject* obj, const QString& newname, const QString& oldname);
+
private slots:
- void dataAvailable();
- void detachSender();
- void removePeerBySender();
+ void removePeerBySender();
+ void objectRenamed(const QByteArray& classname, const QString& newname, const QString& oldname);
+ void updateSecureState();
signals:
- void peerRemoved(QIODevice* obj);
- void connected();
- void disconnected();
-
+ void peerRemoved(Peer* peer);
+ void connected();
+ void disconnected();
+ void objectInitialized(SyncableObject*);
+ void heartBeatIntervalChanged(int secs);
+ void maxHeartBeatCountChanged(int max);
+ void lagUpdated(int lag);
+ void secureStateChanged(bool);
+
private:
- void createClassInfo(QObject *obj);
- void setArgTypes(QObject* obj, int methodId);
- void setMethodName(QObject* obj, int methodId);
+ template<class T>
+ class PeerMessageEvent;
- void receivePeerSignal(const QVariant &packedFunc);
+ void init();
+ void initServer();
+ void initClient();
- void _detachSignals(QObject *sender);
- void _detachSlots(QObject *receiver);
+ static const QMetaObject* metaObject(const QObject* obj);
- // containg a list of argtypes for fast access
- QHash<QByteArray, ClassInfo*> _classInfo;
+ void removePeer(Peer* peer);
+ void removeAllPeers();
- // we use one SignalRelay per QObject
- QHash<QObject*, SignalRelay *> _relayHash;
+ int nextPeerId() { return _lastPeerId++; }
- // RPC function -> (object, slot ID)
- typedef QPair<QObject*, int> MethodId;
- typedef QMultiHash<QByteArray, MethodId> SlotHash;
- SlotHash _attachedSlots;
-
+ template<class T>
+ void dispatch(const T& protoMessage);
+ template<class T>
+ void dispatch(Peer* peer, const T& protoMessage);
- // Hash of used QIODevices
- QHash<QIODevice*, quint32> _peerByteCount;
+ void handle(Peer* peer, const Protocol::SyncMessage& syncMessage);
+ void handle(Peer* peer, const Protocol::RpcCall& rpcCall);
+ void handle(Peer* peer, const Protocol::InitRequest& initRequest);
+ void handle(Peer* peer, const Protocol::InitData& initData);
- ProxyMode _proxyMode;
+ template<class T>
+ void handle(Peer*, T)
+ {
+ Q_ASSERT(0);
+ }
+
+ bool invokeSlot(QObject* receiver, int methodId, const QVariantList& params, QVariant& returnValue, Peer* peer = nullptr);
+ bool invokeSlot(QObject* receiver, int methodId, const QVariantList& params = QVariantList(), Peer* peer = nullptr);
+
+ void requestInit(SyncableObject* obj);
+ QVariantMap initData(SyncableObject* obj) const;
+ void setInitData(SyncableObject* obj, const QVariantMap& properties);
+
+ static void disconnectDevice(QIODevice* dev, const QString& reason = QString());
+
+ QHash<int, Peer*> _peerMap;
+
+ // containg a list of argtypes for fast access
+ QHash<const QMetaObject*, ExtendedMetaObject*> _extendedMetaObjects;
+
+ // SignalRelay for all manually attached signals
+ SignalRelay* _signalRelay;
+
+ // RPC function -> (object, slot ID)
+ using MethodId = QPair<QObject*, int>;
+ using SlotHash = QMultiHash<QByteArray, MethodId>;
+ SlotHash _attachedSlots;
+
+ // slaves for sync
+ using ObjectId = QHash<QString, SyncableObject*>;
+ QHash<QByteArray, ObjectId> _syncSlave;
+
+ ProxyMode _proxyMode;
+ int _heartBeatInterval;
+ int _maxHeartBeatCount;
+
+ bool _secure; // determines if all connections are in a secured state (using ssl or internal connections)
+
+ int _lastPeerId = 0;
+
+ QSet<Peer*> _restrictedTargets;
+ bool _restrictMessageTarget = false;
+
+ Peer* _sourcePeer = nullptr;
+ Peer* _targetPeer = nullptr;
+
+ friend class SignalRelay;
+ friend class SyncableObject;
+ friend class Peer;
};
+// ==================================================
+// ExtendedMetaObject
+// ==================================================
+class SignalProxy::ExtendedMetaObject
+{
+ class MethodDescriptor
+ {
+ public:
+ MethodDescriptor(const QMetaMethod& method);
+ MethodDescriptor() = default;
+ inline const QByteArray& methodName() const { return _methodName; }
+ inline const QList<int>& argTypes() const { return _argTypes; }
+ inline int returnType() const { return _returnType; }
+ inline int minArgCount() const { return _minArgCount; }
+ inline SignalProxy::ProxyMode receiverMode() const { return _receiverMode; }
+ private:
+ QByteArray _methodName;
+ QList<int> _argTypes;
+ int _returnType{-1};
+ int _minArgCount{-1};
+ SignalProxy::ProxyMode _receiverMode{
+ SignalProxy::Client}; // Only acceptable as a Sync Call if the receiving SignalProxy is in this mode.
+ };
-#endif
+public:
+ ExtendedMetaObject(const QMetaObject* meta, bool checkConflicts);
+
+ inline const QByteArray& methodName(int methodId) { return methodDescriptor(methodId).methodName(); }
+ inline const QList<int>& argTypes(int methodId) { return methodDescriptor(methodId).argTypes(); }
+ inline int returnType(int methodId) { return methodDescriptor(methodId).returnType(); }
+ inline int minArgCount(int methodId) { return methodDescriptor(methodId).minArgCount(); }
+ inline SignalProxy::ProxyMode receiverMode(int methodId) { return methodDescriptor(methodId).receiverMode(); }
+
+ inline int methodId(const QByteArray& methodName) { return _methodIds.contains(methodName) ? _methodIds[methodName] : -1; }
+
+ inline int updatedRemotelyId() { return _updatedRemotelyId; }
+
+ inline const QHash<QByteArray, int>& slotMap() { return _methodIds; }
+ const QHash<int, int>& receiveMap();
+
+ const QMetaObject* metaObject() const { return _meta; }
+
+ static QByteArray methodName(const QMetaMethod& method);
+ static QString methodBaseName(const QMetaMethod& method);
+
+private:
+ const MethodDescriptor& methodDescriptor(int methodId);
+
+ const QMetaObject* _meta;
+ int _updatedRemotelyId; // id of the updatedRemotely() signal - makes things faster
+
+ QHash<int, MethodDescriptor> _methods;
+ QHash<QByteArray, int> _methodIds;
+ QHash<int, int> _receiveMap; // if slot x is called then hand over the result to slot y
+};