/**************************************************************************** ** ** Copyright (C) 2017 Ford Motor Company ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the QtRemoteObjects module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "private/qmetaobjectbuilder_p.h" #include "qremoteobjectnode.h" #include "qremoteobjectnode_p.h" #include "qremoteobjectregistry.h" #include "qremoteobjectdynamicreplica.h" #include "qremoteobjectpacket_p.h" #include "qremoteobjectregistrysource_p.h" #include "qremoteobjectreplica_p.h" #include "qremoteobjectsource_p.h" #include "qremoteobjectabstractitemmodelreplica_p.h" #include "qremoteobjectabstractitemmodeladapter_p.h" #include #include QT_BEGIN_NAMESPACE using namespace QtRemoteObjects; using namespace QRemoteObjectStringLiterals; using GadgetType = QVector; using RegisteredType = QPair>; static QMutex s_managedTypesMutex; static QHash s_managedTypes; static QHash> s_trackedConnections; static void GadgetsStaticMetacallFunction(QObject *_o, QMetaObject::Call _c, int _id, void **_a) { if (_c == QMetaObject::ReadProperty) { GadgetType *_t = reinterpret_cast(_o); if (_id < _t->size()) { const auto &prop = _t->at(_id); QMetaType::destruct(int(prop.userType()), _a[0]); QMetaType::construct(int(prop.userType()), _a[0], prop.constData()); } } else if (_c == QMetaObject::WriteProperty) { GadgetType *_t = reinterpret_cast(_o); if (_id < _t->size()) { auto & prop = (*_t)[_id]; prop = QVariant(prop.userType(), _a[0]); } } } static void GadgetTypedDestructor(int, void *ptr) { reinterpret_cast(ptr)->~GadgetType(); } static void *GadgetTypedConstructor(int type, void *where, const void *copy) { GadgetType *ret = where ? new(where) GadgetType : new GadgetType; if (copy) { *ret = *reinterpret_cast(copy); } else { QMutexLocker lock(&s_managedTypesMutex); auto it = s_managedTypes.find(type); if (it == s_managedTypes.end()) { delete ret; return nullptr; } *ret = it->first; } return ret; } static void GadgetSaveOperator(QDataStream & out, const void *data) { const GadgetType *gadgetProperties = reinterpret_cast(data); for (const auto &prop : *gadgetProperties) out << prop; } static void GadgetLoadOperator(QDataStream &in, void *data) { GadgetType *gadgetProperties = reinterpret_cast(data); for (auto &prop : *gadgetProperties) in >> prop; } // Like the Q_GADGET static methods above, we need constructor/destructor methods // in order to use dynamically defined enums with QVariant or as signal/slot // parameters (i.e., the queued connection mechanism, which QtRO leverages). // // We will need the enum methods to support different sizes when typed scope enum // support is added, so might as well use that now. template static void EnumDestructor(void *ptr) { static_cast(ptr)->~T(); } template static void *EnumConstructor(void *where, const void *copy) { T *ret = where ? new(where) T : new T; if (copy) *ret = *static_cast(copy); return ret; } // Not used, but keeping these in case we end up with a need for save/load. template static void EnumSaveOperator(QDataStream & out, const void *data) { const T value = *static_cast(data); out << value; } template static void EnumLoadOperator(QDataStream &in, void *data) { T value = *static_cast(data); in >> value; } static QString name(const QMetaObject * const mobj) { const int ind = mobj->indexOfClassInfo(QCLASSINFO_REMOTEOBJECT_TYPE); return ind >= 0 ? QString::fromLatin1(mobj->classInfo(ind).value()) : QString(); } QString QtRemoteObjects::getTypeNameAndMetaobjectFromClassInfo(const QMetaObject *& meta) { QString typeName; const int ind = meta->indexOfClassInfo(QCLASSINFO_REMOTEOBJECT_TYPE); if (ind != -1) { //We have an object created from repc or at least with QCLASSINFO defined typeName = QString::fromLatin1(meta->classInfo(ind).value()); while (true) { Q_ASSERT(meta->superClass());//This recurses to QObject, which doesn't have QCLASSINFO_REMOTEOBJECT_TYPE //At the point superclass doesn't have the same QCLASSINFO_REMOTEOBJECT_TYPE, //we have the metaobject we should work from if (ind != meta->superClass()->indexOfClassInfo(QCLASSINFO_REMOTEOBJECT_TYPE)) break; meta = meta->superClass(); } } return typeName; } template bool map_contains(const QMap &map, const Query &key, typename QMap::const_iterator &result) { const typename QMap::const_iterator it = map.find(key); if (it == map.end()) return false; result = it; return true; } /*! \qmltype Node \instantiates QRemoteObjectNode \inqmlmodule QtRemoteObjects \brief A node on a Qt Remote Objects network. The Node type provides an entry point to a Qt Remote Objects network. A network can be as simple as two nodes, or an arbitrarily complex set of processes and devices. A Node does not have a url that other nodes can connect to, and thus is able to acquire replicas only. It is not able to share source objects. */ QRemoteObjectNodePrivate::QRemoteObjectNodePrivate() : QObjectPrivate() , registry(nullptr) , retryInterval(250) , lastError(QRemoteObjectNode::NoError) , persistedStore(nullptr) { } QRemoteObjectNodePrivate::~QRemoteObjectNodePrivate() { } QRemoteObjectSourceLocations QRemoteObjectNodePrivate::remoteObjectAddresses() const { if (registry) return registry->sourceLocations(); return QRemoteObjectSourceLocations(); } QRemoteObjectSourceLocations QRemoteObjectRegistryHostPrivate::remoteObjectAddresses() const { if (registrySource) return registrySource->sourceLocations(); return QRemoteObjectSourceLocations(); } /*! \reimp */ void QRemoteObjectNode::timerEvent(QTimerEvent*) { Q_D(QRemoteObjectNode); for (auto it = d->pendingReconnect.begin(), end = d->pendingReconnect.end(); it != end; /*erasing*/) { const auto &conn = *it; if (conn->isOpen()) { it = d->pendingReconnect.erase(it); } else { conn->connectToServer(); ++it; } } if (d->pendingReconnect.isEmpty()) d->reconnectTimer.stop(); qRODebug(this) << "timerEvent" << d->pendingReconnect.size(); } /*! \qmlproperty int Node::heartbeatInterval Heartbeat interval in ms. The heartbeat (only helpful for socket connections) will periodically send a message to connected nodes to detect whether the connection was disrupted. Qt Remote Objects will try to reconnect automatically if it detects a dropped connection. This function can help with that detection since the client will only detect that the server is unavailable when it tries to send data. A value of \c 0 (the default) will disable the heartbeat. */ /*! \property QRemoteObjectNode::heartbeatInterval \brief Heartbeat interval in ms. The heartbeat (only helpful for socket connections) will periodically send a message to connected nodes to detect whether the connection was disrupted. Qt Remote Objects will try to reconnect automatically if it detects a dropped connection. This function can help with that detection since the client will only detect that the server is unavailable when it tries to send data. A value of \c 0 (the default) will disable the heartbeat. */ int QRemoteObjectNode::heartbeatInterval() const { Q_D(const QRemoteObjectNode); return d->m_heartbeatInterval; } void QRemoteObjectNode::setHeartbeatInterval(int interval) { Q_D(QRemoteObjectNode); if (d->m_heartbeatInterval == interval) return; d->m_heartbeatInterval = interval; emit heartbeatIntervalChanged(interval); } /*! \since 5.12 \typedef QRemoteObjectNode::RemoteObjectSchemaHandler Typedef for a std::function method that can take a QUrl input and is responsible for creating the communications channel between this node and the node hosting the desired \l Source. As some types of QIODevices (e.g., QSslSocket) require additional steps before the device is ready for use, the method is responsible for calling \l addClientSideConnection once the connection is fully established. */ /*! \since 5.12 \brief Provide a custom method to handle externally provided schemas This method is tied to the \l Registry and \l {External Schemas}. By registering a std::function handler for an external schema, the registered method will be called when the registry is notified of a \l Source you've acquired being available. Without this registration, QtRO would only be able to handle the "built-in" schemas. The provided method, \a handler, will be called when the registry sees a \l Source object on a new (not yet connected) Node with a {QUrl::schema()} of \a schema. The \a handler, of type \l QRemoteObjectNode::RemoteObjectSchemaHandler will get the \l QUrl of the Node providing the \l Source as an input parameter, and is responsible for establishing the communications channel (a \l QIODevice of some sort) and calling \l addClientSideConnection with it. \sa RemoteObjectSchemaHandler */ void QRemoteObjectNode::registerExternalSchema(const QString &schema, QRemoteObjectNode::RemoteObjectSchemaHandler handler) { Q_D(QRemoteObjectNode); d->schemaHandlers.insert(schema, handler); } /*! \since 5.11 \brief Forward Remote Objects from another network The proxy functionality is useful when you want to share \l Source objects over multiple networks. For instance, if you have an embedded target using target-only connections (like local) and you want to make some of those same objects available externally. As a concrete example, say you have a set of processes talking to each other on your target hardware using a registry, with the \l Registry at "local:registry" and separate processes using a node at "local:MyHost" that holds \l Source objects. If you wanted to access these objects, but over tcp, you could create a new proxyNode like so: \code // myInternalHost is a node only visible on the device... QRemoteObjectHost myInternalHost("local:MyHost"); myInternalHost.enableRemoting(&someObject); // Regular host node, listening on port 12123, so visible to other // devices QRemoteObjectHost proxyNode("tcp://localhost:12123"); // Enable proxying objects from nodes on the local machine's internal // QtRO bus proxyNode.proxy("local:registry"); \endcode And from another device you create another node: \code // NB: localhost resolves to a different ip address than proxyNode QRemoteObjectHost nodeOnRemoteDevice("tcp://localhost:23234"); // Connect to the target's proxyNode directly, or use a tcp registry... nodeOnRemoteDevice.connectToNode("tcp://:12123"); // Because of the proxy, we can get the object over tcp/ip port 12123, // even though we can't connect directly to "local:MyHost" SomeObject *so = nodeOnRemoteDevice.acquire(); \endcode This would (internally) create a node in proxyNode, which (again internally/automatically) connects to the provided registry (given by the \a registryUrl parameter, "local:registry" in this example). Whenever local:registry emits the \l remoteObjectAdded signal, the \c QRemoteObjectSourceLocation is passed to the \a filter given to the proxy call. If this method returns true (the default filter simply returns true without any filtering), the object is acquired() from the internal node and enableRemoting() (once the replica is initialized) is called on proxyNode. If a \a hostUrl is provided (which is required to enable reverseProxy, but not needed otherwise), the internal node will be a \l QRemoteObjectHost node configured with the provided address. If no \a hostUrl is provided, the internal node will be a QRemoteObjectNode (not HostNode). Returns \c true if the object is acquired from the internal node. \sa reverseProxy() */ bool QRemoteObjectHostBase::proxy(const QUrl ®istryUrl, const QUrl &hostUrl, RemoteObjectNameFilter filter) { Q_D(QRemoteObjectHostBase); if (!registryUrl.isValid() || !QtROClientFactory::instance()->isValid(registryUrl)) { qROWarning(this) << "Can't proxy to registryUrl (invalid url or schema)" << registryUrl; return false; } if (!hostUrl.isEmpty() && !QtROClientFactory::instance()->isValid(hostUrl)) { qROWarning(this) << "Can't proxy using hostUrl (invalid schema)" << hostUrl; return false; } if (d->proxyInfo) { qROWarning(this) << "Proxying from multiple objects is currently not supported."; return false; } QRemoteObjectNode *node; if (hostUrl.isEmpty()) { node = new QRemoteObjectNode(registryUrl); } else { node = new QRemoteObjectHost(hostUrl, registryUrl); } d->proxyInfo = new ProxyInfo(node, this, filter); return true; } /*! \since 5.11 \brief Forward Remote Objects to another network The reverseProxy() function allows the \l proxy() functionality to be extended, in effect mirroring the proxy functionality in the "reverse" direction. These are distinct, because node communication is not symmetric, one side calls enableRemoting() with a \l Source object, the other side calls acquire() to get a \l Replica. Using \l proxy() allows you to "observe" objects on a target device remotely via acquire, but it does not allow off-target \l Source objects to be acquired from the device's local:* network. That is where \l reverseProxy() comes in. If a proxyNode is created like so: \code // myInternalHost is a node only visible on the device... QRemoteObjectHost myInternalHost("local:MyHost"); // Regular host node, listening on port 12123, so visible to other // devices QRemoteObjectHost proxyNode("tcp://localhost:12123"); // Enable proxying objects from nodes on the local machine's internal // QtRO bus. Note the hostUrl parameter is now needed. proxyNode.proxy("local:registry", "local:fromProxy"); proxyNode.reverseProxy(); \endcode And from another device you create another node: \code // NB: localhost resolves to a different ip address than proxyNode QRemoteObjectHost nodeOnRemoteDevice("tcp://localhost:23234"); // Connect to the target's proxyNode directly, or use a tcp registry... nodeOnRemoteDevice.connectToNode("tcp://:12123"); // Because of the reverseProxy, we can expose objects on this device // and they will make their way to proxyNode... nodeOnRemoteDevice.enableRemoting(&otherObject); \endcode \code // Acquire() can now see the objects on other devices through proxyNode, // due to the reverseProxy call. OtherObject *oo = myInternalHost.acquire(); \endcode While the \l proxy() functionality allows \l Source objects on another network to be acquired(), reverseProxy() allows \l Source objects to be "pushed" to an otherwise inaccessible network. \note proxy() needs to be called before \l reverseProxy(), and a hostUrl needs to be provided to \l proxy for \l reverseProxy() to work. The \l reverseProxy() method allows a separate \a filter to be applied. This reverseProxy specific filter will receive notifications of new \l Source objects on proxyNode and acquire them on the internal node if they pass the reverseFilter. \sa proxy() */ bool QRemoteObjectHostBase::reverseProxy(QRemoteObjectHostBase::RemoteObjectNameFilter filter) { Q_D(QRemoteObjectHostBase); if (!d->proxyInfo) { qROWarning(this) << "proxy() needs to be called before setting up reverse proxy."; return false; } QRemoteObjectHost *host = qobject_cast(d->proxyInfo->proxyNode); if (!host) { qROWarning(this) << "proxy() needs called with host-url to enable reverse proxy."; return false; } return d->proxyInfo->setReverseProxy(filter); } /*! \internal The replica needs to have a default constructor to be able to create a replica from QML. In order for it to be properly constructed, there needs to be a way to associate the replica with a node and start the replica initialization. Thus we need a public method on node to facilitate that. That's initializeReplica. */ void QRemoteObjectNode::initializeReplica(QRemoteObjectReplica *instance, const QString &name) { Q_D(QRemoteObjectNode); if (instance->inherits("QRemoteObjectDynamicReplica")) { d->setReplicaImplementation(nullptr, instance, name); } else { const QMetaObject *meta = instance->metaObject(); // This is a templated acquire, so we tell the Source we don't need // them to send the class definition. Thus we need to store the // metaObject for this class - if this is a nested class, the QObject // could be a nullptr or updated from the source, d->dynamicTypeManager.addFromMetaObject(meta); d->setReplicaImplementation(meta, instance, name.isEmpty() ? ::name(meta) : name); } } void QRemoteObjectNodePrivate::setLastError(QRemoteObjectNode::ErrorCode errorCode) { Q_Q(QRemoteObjectNode); lastError = errorCode; emit q->error(lastError); } void QRemoteObjectNodePrivate::setReplicaImplementation(const QMetaObject *meta, QRemoteObjectReplica *instance, const QString &name) { qROPrivDebug() << "Starting setReplicaImplementation for" << name; openConnectionIfNeeded(name); QMutexLocker locker(&mutex); if (hasInstance(name)) { qCDebug(QT_REMOTEOBJECT)<<"setReplicaImplementation - using existing instance"; QSharedPointer rep = qSharedPointerCast(replicas.value(name).toStrongRef()); Q_ASSERT(rep); instance->d_impl = rep; rep->configurePrivate(instance); } else { instance->d_impl.reset(handleNewAcquire(meta, instance, name)); instance->initialize(); replicas.insert(name, instance->d_impl.toWeakRef()); qROPrivDebug() << "setReplicaImplementation - Created new instance" << name<registry; } /*! \class QRemoteObjectAbstractPersistedStore \inmodule QtRemoteObjects \brief A class which provides the methods for setting PROP values of a replica to value they had the last time the replica was used. This can be used to provide a "reasonable" value to be displayed until the connection to the source is established and current values are available. This class must be overridden to provide an implementation for saving (\l QRemoteObjectAbstractPersistedStore::saveProperties) and restoring (\l QRemoteObjectAbstractPersistedStore::restoreProperties) PROP values. The derived type can then be set for a node, and any replica acquired from that node will then automatically store PERSISTED properties when the replica destructor is called, and retrieve the values when the replica is instantiated. */ /*! Constructs a QRemoteObjectAbstractPersistedStore with the given \a parent. The default value of \a parent is \c nullptr. */ QRemoteObjectAbstractPersistedStore::QRemoteObjectAbstractPersistedStore(QObject *parent) : QObject(parent) { } QRemoteObjectAbstractPersistedStore::~QRemoteObjectAbstractPersistedStore() { } /*! \fn virtual void QRemoteObjectAbstractPersistedStore::saveProperties(const QString &repName, const QByteArray &repSig, const QVariantList &values) This method will be provided the replica class's \a repName, \a repSig and the list of \a values that PERSISTED properties have when the replica destructor was called. It is the responsibility of the inheriting class to store the information in a manner consistent for \l QRemoteObjectAbstractPersistedStore::restoreProperties to retrieve. \sa QRemoteObjectAbstractPersistedStore::restoreProperties */ /*! \fn virtual QVariantList QRemoteObjectAbstractPersistedStore::restoreProperties(const QString &repName, const QByteArray &repSig) This method will be provided the replica class's \a repName and \a repSig when the replica is being initialized. It is the responsibility of the inheriting class to get the last values persisted by \l QRemoteObjectAbstractPersistedStore::saveProperties and return them. An empty QVariantList should be returned if no values are available. \sa QRemoteObjectAbstractPersistedStore::saveProperties */ QRemoteObjectAbstractPersistedStore *QRemoteObjectNode::persistedStore() const { Q_D(const QRemoteObjectNode); return d->persistedStore; } /*! \qmlproperty QRemoteObjectAbstractPersistedStore Node::persistedStore Allows setting a \l QRemoteObjectAbstractPersistedStore instance for the node. Allows replica \l PROP members with the PERSISTED trait to save their current value when the replica is deleted and restore a stored value the next time the replica is started. Requires a \l QRemoteObjectAbstractPersistedStore class implementation to control where and how persistence is handled. A default QSettings-based implementation is provided by SettingsStore. */ /*! \since 5.11 \property QRemoteObjectNode::persistedStore \brief Allows setting a \l QRemoteObjectAbstractPersistedStore instance for the node. Allows replica \l PROP members with the PERSISTED trait to save their current value when the replica is deleted and restore a stored value the next time the replica is started. Requires a \l QRemoteObjectAbstractPersistedStore class implementation to control where and how persistence is handled. */ void QRemoteObjectNode::setPersistedStore(QRemoteObjectAbstractPersistedStore *persistedStore) { Q_D(QRemoteObjectNode); d->persistedStore = persistedStore; } QRemoteObjectAbstractPersistedStore::QRemoteObjectAbstractPersistedStore(QRemoteObjectAbstractPersistedStorePrivate &dptr, QObject *parent) : QObject(dptr, parent) { } QRemoteObjectAbstractPersistedStorePrivate::QRemoteObjectAbstractPersistedStorePrivate() { } QRemoteObjectAbstractPersistedStorePrivate::~QRemoteObjectAbstractPersistedStorePrivate() { } QRemoteObjectMetaObjectManager::~QRemoteObjectMetaObjectManager() { for (QMetaObject *mo : dynamicTypes) free(mo); //QMetaObjectBuilder uses malloc, not new } const QMetaObject *QRemoteObjectMetaObjectManager::metaObjectForType(const QString &type) { qCDebug(QT_REMOTEOBJECT) << "metaObjectForType: looking for" << type << "static keys:" << staticTypes.keys() << "dynamic keys:" << dynamicTypes.keys(); Q_ASSERT(staticTypes.contains(type) || dynamicTypes.contains(type)); auto it = staticTypes.constFind(type); if (it != staticTypes.constEnd()) return it.value(); return dynamicTypes.value(type); } static void trackConnection(int typeId, IoDeviceBase *connection) { QMutexLocker lock(&s_managedTypesMutex); if (s_trackedConnections[typeId].contains(connection)) return; s_trackedConnections[typeId].insert(connection); auto unregisterIfNotUsed = [typeId, connection]{ QMutexLocker lock(&s_managedTypesMutex); Q_ASSERT(s_trackedConnections.contains(typeId)); Q_ASSERT(s_trackedConnections[typeId].contains(connection)); s_trackedConnections[typeId].remove(connection); if (s_trackedConnections[typeId].isEmpty()) { s_trackedConnections.remove(typeId); s_managedTypes.remove(typeId); QMetaType::unregisterType(typeId); } }; // Unregister the type only when the connection is destroyed // Do not unregister types when the connections is discconected, because // if it gets reconnected it will not register the types again QObject::connect(connection, &IoDeviceBase::destroyed, unregisterIfNotUsed); } struct EnumPair { QByteArray name; int value; }; struct EnumData { QByteArray name; bool isFlag, isScoped; quint32 keyCount, size; QVector values; }; struct GadgetProperty { QByteArray name; QByteArray type; }; struct GadgetData { QVector properties; QVector enums; }; using Gadgets = QHash; static void registerEnum(const QByteArray &name, const QMetaObject *meta, int size=4) { // When we add support for enum classes, we will need to set this to something like // QByteArray(enumClass).append("::").append(enumMeta.name()) when enumMeta.isScoped() is true. // That is a new feature, though. if (QMetaType::isRegistered(QMetaType::type(name))) return; static const auto flags = QMetaType::IsEnumeration | QMetaType::NeedsConstruction | QMetaType::NeedsDestruction; int id; switch (size) { case 1: id = QMetaType::registerType(name.constData(), nullptr, nullptr, &EnumDestructor, &EnumConstructor, size, flags, meta); break; case 2: id = QMetaType::registerType(name.constData(), nullptr, nullptr, &EnumDestructor, &EnumConstructor, size, flags, meta); break; case 4: id = QMetaType::registerType(name.constData(), nullptr, nullptr, &EnumDestructor, &EnumConstructor, size, flags, meta); break; // Qt currently only supports enum values of 4 or less bytes (QMetaEnum value(index) returns int) // case 8: id = QMetaType::registerType(name.constData(), nullptr, nullptr, &EnumDestructor, // &EnumConstructor, size, flags, meta); // break; default: qWarning() << "Invalid enum detected" << name << "with size" << size << ". Defaulting to register as int."; id = QMetaType::registerType(name.constData(), nullptr, nullptr, &EnumDestructor, &EnumConstructor, size, flags, meta); } #ifdef QTRO_VERBOSE_PROTOCOL qDebug() << "Registering new enum with id" << id << name << "size:" << size; #endif qCDebug(QT_REMOTEOBJECT) << "Registering new enum with id" << id << name << "size:" << size; } static int registerGadgets(IoDeviceBase *connection, Gadgets &gadgets, QByteArray typeName) { const auto &gadget = gadgets.take(typeName); int typeId = QMetaType::type(typeName); if (typeId != QMetaType::UnknownType) { trackConnection(typeId, connection); return typeId; } QMetaObjectBuilder gadgetBuilder; gadgetBuilder.setClassName(typeName); gadgetBuilder.setFlags(QMetaObjectBuilder::DynamicMetaObject | QMetaObjectBuilder::PropertyAccessInStaticMetaCall); GadgetType gadgetType; for (const auto &prop : gadget.properties) { int propertyType = QMetaType::type(prop.type); if (!propertyType && gadgets.contains(prop.type)) propertyType = registerGadgets(connection, gadgets, prop.type); gadgetType.push_back(QVariant(QVariant::Type(propertyType))); auto dynamicProperty = gadgetBuilder.addProperty(prop.name, prop.type); dynamicProperty.setWritable(true); dynamicProperty.setReadable(true); } for (const auto &enumData: gadget.enums) { auto enumBuilder = gadgetBuilder.addEnumerator(enumData.name); enumBuilder.setIsFlag(enumData.isFlag); enumBuilder.setIsScoped(enumData.isScoped); for (quint32 k = 0; k < enumData.keyCount; ++k) { const auto pair = enumData.values.at(k); enumBuilder.addKey(pair.name, pair.value); } } auto meta = gadgetBuilder.toMetaObject(); const auto enumCount = meta->enumeratorCount(); for (int i = 0; i < enumCount; i++) { const QByteArray registeredName = QByteArray(typeName).append("::").append(meta->enumerator(i).name()); registerEnum(registeredName, meta, gadget.enums.at(i).size); } QMetaType::TypeFlags flags = QMetaType::IsGadget; int gadgetTypeId; if (meta->propertyCount()) { meta->d.static_metacall = &GadgetsStaticMetacallFunction; meta->d.superdata = nullptr; flags |= QMetaType::NeedsConstruction | QMetaType::NeedsDestruction; gadgetTypeId = QMetaType::registerType(typeName.constData(), &GadgetTypedDestructor, &GadgetTypedConstructor, sizeof(GadgetType), flags, meta); QMetaType::registerStreamOperators(gadgetTypeId, &GadgetSaveOperator, &GadgetLoadOperator); } else { gadgetTypeId = QMetaType::registerType(typeName.constData(), nullptr, nullptr, sizeof(GadgetType), flags, meta); } trackConnection(gadgetTypeId, connection); QMutexLocker lock(&s_managedTypesMutex); s_managedTypes[gadgetTypeId] = qMakePair(gadgetType, std::shared_ptr{meta, [](QMetaObject *ptr){ ::free(ptr); }}); return gadgetTypeId; } static void registerAllGadgets(IoDeviceBase *connection, Gadgets &gadgets) { while (!gadgets.isEmpty()) registerGadgets(connection, gadgets, gadgets.constBegin().key()); } static void deserializeEnum(QDataStream &ds, EnumData &enumData) { ds >> enumData.name; ds >> enumData.isFlag; ds >> enumData.isScoped; ds >> enumData.size; ds >> enumData.keyCount; for (quint32 i = 0; i < enumData.keyCount; i++) { EnumPair pair; ds >> pair.name; ds >> pair.value; enumData.values.push_back(pair); } } static void parseGadgets(IoDeviceBase *connection, QDataStream &in) { quint32 qtEnums, numGadgets; in >> qtEnums; // Qt enums - just need registration for (quint32 i = 0; i < qtEnums; ++i) { QByteArray enumName; in >> enumName; QMetaType t(QMetaType::type(enumName.constData())); registerEnum(enumName, t.metaObject()); // All Qt enums have default type int } in >> numGadgets; if (numGadgets == 0) return; Gadgets gadgets; for (quint32 i = 0; i < numGadgets; ++i) { QByteArray type; in >> type; quint32 numProperties, numEnums; in >> numProperties; auto &properties = gadgets[type].properties; for (quint32 p = 0; p < numProperties; ++p) { GadgetProperty prop; in >> prop.name; in >> prop.type; properties.push_back(prop); } in >> numEnums; auto &enums = gadgets[type].enums; for (quint32 e = 0; e < numEnums; ++e) { EnumData enumData; deserializeEnum(in, enumData); enums.push_back(enumData); } } registerAllGadgets(connection, gadgets); } QMetaObject *QRemoteObjectMetaObjectManager::addDynamicType(IoDeviceBase *connection, QDataStream &in) { QMetaObjectBuilder builder; builder.setSuperClass(&QRemoteObjectReplica::staticMetaObject); builder.setFlags(QMetaObjectBuilder::DynamicMetaObject); QString typeString; QByteArray type; quint32 numEnums = 0; quint32 numSignals = 0; quint32 numMethods = 0; quint32 numProperties = 0; in >> typeString; type = typeString.toLatin1(); builder.addClassInfo(QCLASSINFO_REMOTEOBJECT_TYPE, type); builder.setClassName(type); in >> numEnums; QVector enumSizes(numEnums); for (quint32 i = 0; i < numEnums; ++i) { EnumData enumData; deserializeEnum(in, enumData); auto enumBuilder = builder.addEnumerator(enumData.name); enumBuilder.setIsFlag(enumData.isFlag); enumBuilder.setIsScoped(enumData.isScoped); enumSizes[i] = enumData.size; for (quint32 k = 0; k < enumData.keyCount; ++k) { const auto pair = enumData.values.at(k); enumBuilder.addKey(pair.name, pair.value); } } parseGadgets(connection, in); int curIndex = 0; in >> numSignals; for (quint32 i = 0; i < numSignals; ++i) { QByteArray signature; QList paramNames; in >> signature; in >> paramNames; ++curIndex; auto mmb = builder.addSignal(signature); mmb.setParameterNames(paramNames); } in >> numMethods; for (quint32 i = 0; i < numMethods; ++i) { QByteArray signature, returnType; QList paramNames; in >> signature; in >> returnType; in >> paramNames; ++curIndex; const bool isVoid = returnType.isEmpty() || returnType == QByteArrayLiteral("void"); QMetaMethodBuilder mmb; if (isVoid) mmb = builder.addMethod(signature); else mmb = builder.addMethod(signature, QByteArrayLiteral("QRemoteObjectPendingCall")); mmb.setParameterNames(paramNames); } in >> numProperties; for (quint32 i = 0; i < numProperties; ++i) { QByteArray name; QByteArray typeName; QByteArray signalName; in >> name; in >> typeName; in >> signalName; if (signalName.isEmpty()) builder.addProperty(name, typeName); else builder.addProperty(name, typeName, builder.indexOfSignal(signalName)); } auto meta = builder.toMetaObject(); // Our type likely has enumerations from the inherited base classes, such as the Replica State // We only want to register the new enumerations, and since we just added them, we know they // are the last indices. Thus a backwards count seems most efficient. const int totalEnumCount = meta->enumeratorCount(); int incrementingIndex = 0; for (int i = numEnums; i > 0; i--) { auto const enumMeta = meta->enumerator(totalEnumCount - i); const QByteArray registeredName = QByteArray(type).append("::").append(enumMeta.name()); registerEnum(registeredName, meta, enumSizes.at(incrementingIndex++)); } dynamicTypes.insert(typeString, meta); return meta; } void QRemoteObjectMetaObjectManager::addFromMetaObject(const QMetaObject *metaObject) { QString className = QLatin1String(metaObject->className()); if (!className.endsWith(QLatin1String("Replica"))) return; if (className == QLatin1String("QRemoteObjectDynamicReplica") || staticTypes.contains(className)) return; className.chop(7); //Remove 'Replica' from name staticTypes.insert(className, metaObject); } void QRemoteObjectNodePrivate::connectReplica(QObject *object, QRemoteObjectReplica *instance) { int nConnections = 0; const QMetaObject *us = instance->metaObject(); const QMetaObject *them = object->metaObject(); static const int memberOffset = QRemoteObjectReplica::staticMetaObject.methodCount(); for (int idx = memberOffset; idx < us->methodCount(); ++idx) { const QMetaMethod mm = us->method(idx); qROPrivDebug() << idx << mm.name(); if (mm.methodType() != QMetaMethod::Signal) continue; // try to connect to a signal on the parent that has the same method signature QByteArray sig = QMetaObject::normalizedSignature(mm.methodSignature().constData()); qROPrivDebug() << sig; if (them->indexOfSignal(sig.constData()) == -1) continue; sig.prepend(QSIGNAL_CODE + '0'); const char * const csig = sig.constData(); const bool res = QObject::connect(object, csig, instance, csig); Q_UNUSED(res); ++nConnections; qROPrivDebug() << sig << res; } qROPrivDebug() << "# connections =" << nConnections; } void QRemoteObjectNodePrivate::openConnectionIfNeeded(const QString &name) { qROPrivDebug() << Q_FUNC_INFO << name << this; if (!remoteObjectAddresses().contains(name)) { qROPrivDebug() << name << "not available - available addresses:" << remoteObjectAddresses(); return; } if (!initConnection(remoteObjectAddresses().value(name).hostUrl)) qROPrivWarning() << "failed to open connection to" << name; } bool QRemoteObjectNodePrivate::initConnection(const QUrl &address) { Q_Q(QRemoteObjectNode); if (requestedUrls.contains(address)) { qROPrivDebug() << "Connection already requested for " << address.toString(); return true; } requestedUrls.insert(address); if (schemaHandlers.contains(address.scheme())) { schemaHandlers[address.scheme()](address); return true; } ClientIoDevice *connection = QtROClientFactory::instance()->create(address, q); if (!connection) { qROPrivWarning() << "Could not create ClientIoDevice for client. Invalid url/scheme provided?" << address; return false; } qROPrivDebug() << "Opening connection to" << address.toString(); qROPrivDebug() << "Replica Connection isValid" << connection->isOpen(); QObject::connect(connection, &ClientIoDevice::shouldReconnect, q, [this, connection]() { onShouldReconnect(connection); }); QObject::connect(connection, &IoDeviceBase::readyRead, q, [this, connection]() { onClientRead(connection); }); connection->connectToServer(); return true; } bool QRemoteObjectNodePrivate::hasInstance(const QString &name) { if (!replicas.contains(name)) return false; QSharedPointer rep = replicas.value(name).toStrongRef(); if (!rep) { //already deleted replicas.remove(name); return false; } return true; } void QRemoteObjectNodePrivate::onRemoteObjectSourceAdded(const QRemoteObjectSourceLocation &entry) { qROPrivDebug() << "onRemoteObjectSourceAdded" << entry << replicas << replicas.contains(entry.first); if (!entry.first.isEmpty()) { QRemoteObjectSourceLocations locs = registry->sourceLocations(); locs[entry.first] = entry.second; //TODO Is there a way to extend QRemoteObjectSourceLocations in place? registry->d_impl->setProperty(0, QVariant::fromValue(locs)); qROPrivDebug() << "onRemoteObjectSourceAdded, now locations =" << locs; } if (replicas.contains(entry.first)) //We have a replica waiting on this remoteObject { QSharedPointer rep = replicas.value(entry.first).toStrongRef(); if (!rep) { //replica has been deleted, remove from list replicas.remove(entry.first); return; } initConnection(entry.second.hostUrl); qROPrivDebug() << "Called initConnection due to new RemoteObjectSource added via registry" << entry.first; } } void QRemoteObjectNodePrivate::onRemoteObjectSourceRemoved(const QRemoteObjectSourceLocation &entry) { if (!entry.first.isEmpty()) { QRemoteObjectSourceLocations locs = registry->sourceLocations(); locs.remove(entry.first); registry->d_impl->setProperty(0, QVariant::fromValue(locs)); } } void QRemoteObjectNodePrivate::onRegistryInitialized() { qROPrivDebug() << "Registry Initialized" << remoteObjectAddresses(); const auto remotes = remoteObjectAddresses(); for (auto i = remotes.cbegin(), end = remotes.cend(); i != end; ++i) { if (replicas.contains(i.key())) //We have a replica waiting on this remoteObject { QSharedPointer rep = replicas.value(i.key()).toStrongRef(); if (rep && !requestedUrls.contains(i.value().hostUrl)) initConnection(i.value().hostUrl); else if (!rep) //replica has been deleted, remove from list replicas.remove(i.key()); continue; } } } void QRemoteObjectNodePrivate::onShouldReconnect(ClientIoDevice *ioDevice) { Q_Q(QRemoteObjectNode); const auto remoteObjects = ioDevice->remoteObjects(); for (const QString &remoteObject : remoteObjects) { connectedSources.remove(remoteObject); ioDevice->removeSource(remoteObject); if (replicas.contains(remoteObject)) { //We have a replica waiting on this remoteObject QSharedPointer rep = qSharedPointerCast(replicas.value(remoteObject).toStrongRef()); if (rep && !rep->connectionToSource.isNull()) { rep->setDisconnected(); } else if (!rep) { replicas.remove(remoteObject); } } } if (requestedUrls.contains(ioDevice->url())) { // Only try to reconnect to URLs requested via connectToNode // If we connected via registry, wait for the registry to see the node/source again pendingReconnect.insert(ioDevice); if (!reconnectTimer.isActive()) { reconnectTimer.start(retryInterval, q); qROPrivDebug() << "Starting reconnect timer"; } } else { qROPrivDebug() << "Url" << ioDevice->url().toDisplayString().toLatin1() << "lost. We will reconnect Replicas if they reappear on the Registry."; } } //This version of handleNewAcquire creates a QConnectedReplica. If this is a //host node, the QRemoteObjectHostBasePrivate overload is called instead. QReplicaImplementationInterface *QRemoteObjectNodePrivate::handleNewAcquire(const QMetaObject *meta, QRemoteObjectReplica *instance, const QString &name) { Q_Q(QRemoteObjectNode); QConnectedReplicaImplementation *rp = new QConnectedReplicaImplementation(name, meta, q); rp->configurePrivate(instance); if (connectedSources.contains(name)) { //Either we have a peer connections, or existing connection via registry handleReplicaConnection(connectedSources[name].objectSignature, rp, connectedSources[name].device); } else { //No existing connection, but we know we can connect via registry const auto &sourceLocations = remoteObjectAddresses(); const auto it = sourceLocations.constFind(name); // This will try the connection, and if successful, the remoteObjects will be sent // The link to the replica will be handled then if (it != sourceLocations.constEnd()) initConnection(it.value().hostUrl); } return rp; } void QRemoteObjectNodePrivate::handleReplicaConnection(const QString &name) { QSharedPointer rep = qSharedPointerCast(replicas.value(name).toStrongRef()); if (!rep) { //replica has been deleted, remove from list replicas.remove(name); return; } if (rep->isShortCircuit()) return; QConnectedReplicaImplementation *connectedRep = static_cast(rep.data()); if (connectedRep->connectionToSource.isNull()) { const auto sourceInfo = connectedSources.value(name); handleReplicaConnection(sourceInfo.objectSignature, connectedRep, sourceInfo.device); } } void QRemoteObjectNodePrivate::handleReplicaConnection(const QByteArray &sourceSignature, QConnectedReplicaImplementation *rep, IoDeviceBase *connection) { if (!checkSignatures(rep->m_objectSignature, sourceSignature)) { qROPrivWarning() << "Signature mismatch for" << rep->m_metaObject->className() << (rep->m_objectName.isEmpty() ? QLatin1String("(unnamed)") : rep->m_objectName); rep->setState(QRemoteObjectReplica::SignatureMismatch); return; } rep->setConnection(connection); } //Host Nodes can use the more efficient InProcess Replica if we (this Node) hold the Source for the //requested Replica. If not, fall back to the Connected Replica case. QReplicaImplementationInterface *QRemoteObjectHostBasePrivate::handleNewAcquire(const QMetaObject *meta, QRemoteObjectReplica *instance, const QString &name) { QMap::const_iterator mapIt; if (remoteObjectIo && map_contains(remoteObjectIo->m_sourceObjects, name, mapIt)) { Q_Q(QRemoteObjectHostBase); QInProcessReplicaImplementation *rp = new QInProcessReplicaImplementation(name, meta, q); rp->configurePrivate(instance); connectReplica(mapIt.value()->m_object, instance); rp->connectionToSource = mapIt.value(); return rp; } return QRemoteObjectNodePrivate::handleNewAcquire(meta, instance, name); } void QRemoteObjectNodePrivate::onClientRead(QObject *obj) { using namespace QRemoteObjectPackets; IoDeviceBase *connection = qobject_cast(obj); QRemoteObjectPacketTypeEnum packetType; Q_ASSERT(connection); do { if (!connection->read(packetType, rxName)) return; if (packetType != Handshake && !m_handshakeReceived) { qROPrivWarning() << "Expected Handshake, got " << packetType; setLastError(QRemoteObjectNode::ProtocolMismatch); connection->close(); break; } switch (packetType) { case Pong: { QSharedPointer rep = qSharedPointerCast(replicas.value(rxName).toStrongRef()); if (rep) rep->notifyAboutReply(0, {}); else //replica has been deleted, remove from list replicas.remove(rxName); break; } case Handshake: if (rxName != QtRemoteObjects::protocolVersion) { qWarning() << "*** Protocol Mismatch, closing connection ***. Got" << rxName << "expected" << QtRemoteObjects::protocolVersion; setLastError(QRemoteObjectNode::ProtocolMismatch); connection->close(); } else { m_handshakeReceived = true; } break; case ObjectList: { deserializeObjectListPacket(connection->stream(), rxObjects); qROPrivDebug() << "newObjects:" << rxObjects; // We need to make sure all of the source objects are in connectedSources before we add connections, // otherwise nested QObjects could fail (we want to acquire children before parents, and the object // list is unordered) for (const auto &remoteObject : qAsConst(rxObjects)) { qROPrivDebug() << " connectedSources.contains(" << remoteObject << ")" << connectedSources.contains(remoteObject.name) << replicas.contains(remoteObject.name); if (!connectedSources.contains(remoteObject.name)) { connectedSources[remoteObject.name] = SourceInfo{connection, remoteObject.typeName, remoteObject.signature}; connection->addSource(remoteObject.name); // Make sure we handle Registry first if it is available if (remoteObject.name == QLatin1String("Registry") && replicas.contains(remoteObject.name)) handleReplicaConnection(remoteObject.name); } } for (const auto &remoteObject : qAsConst(rxObjects)) { if (replicas.contains(remoteObject.name)) //We have a replica waiting on this remoteObject handleReplicaConnection(remoteObject.name); } break; } case InitPacket: { qROPrivDebug() << "InitPacket-->" << rxName << this; QSharedPointer rep = qSharedPointerCast(replicas.value(rxName).toStrongRef()); //Use m_rxArgs (a QVariantList to hold the properties QVariantList) deserializeInitPacket(connection->stream(), rxArgs); if (rep) { handlePointerToQObjectProperties(rep.data(), rxArgs); rep->initialize(rxArgs); } else { //replica has been deleted, remove from list replicas.remove(rxName); } break; } case InitDynamicPacket: { qROPrivDebug() << "InitDynamicPacket-->" << rxName << this; const QMetaObject *meta = dynamicTypeManager.addDynamicType(connection, connection->stream()); deserializeInitPacket(connection->stream(), rxArgs); QSharedPointer rep = qSharedPointerCast(replicas.value(rxName).toStrongRef()); if (rep) { rep->setDynamicMetaObject(meta); handlePointerToQObjectProperties(rep.data(), rxArgs); rep->setDynamicProperties(rxArgs); } else { //replica has been deleted, remove from list replicas.remove(rxName); } break; } case RemoveObject: { qROPrivDebug() << "RemoveObject-->" << rxName << this; connectedSources.remove(rxName); connection->removeSource(rxName); if (replicas.contains(rxName)) { //We have a replica using the removed source QSharedPointer rep = qSharedPointerCast(replicas.value(rxName).toStrongRef()); if (rep && !rep->connectionToSource.isNull()) { rep->connectionToSource.clear(); rep->setState(QRemoteObjectReplica::Suspect); } else if (!rep) { replicas.remove(rxName); } } break; } case PropertyChangePacket: { int propertyIndex; deserializePropertyChangePacket(connection->stream(), propertyIndex, rxValue); QSharedPointer rep = qSharedPointerCast(replicas.value(rxName).toStrongRef()); if (rep) { QConnectedReplicaImplementation *connectedRep = nullptr; if (!rep->isShortCircuit()) { connectedRep = static_cast(rep.data()); if (!connectedRep->childIndices().contains(propertyIndex)) connectedRep = nullptr; //connectedRep will be a valid pointer only if propertyIndex is a child index } if (connectedRep) rep->setProperty(propertyIndex, handlePointerToQObjectProperty(connectedRep, propertyIndex, rxValue)); else { const QMetaProperty property = rep->m_metaObject->property(propertyIndex + rep->m_metaObject->propertyOffset()); if (property.userType() == QMetaType::QVariant && rxValue.canConvert()) { // This is a type that requires registration QRO_ typeInfo = rxValue.value(); QDataStream in(typeInfo.classDefinition); parseGadgets(connection, in); QDataStream ds(typeInfo.parameters); ds >> rxValue; } rep->setProperty(propertyIndex, decodeVariant(rxValue, property.userType())); } } else { //replica has been deleted, remove from list replicas.remove(rxName); } break; } case InvokePacket: { int call, index, serialId, propertyIndex; deserializeInvokePacket(connection->stream(), call, index, rxArgs, serialId, propertyIndex); QSharedPointer rep = qSharedPointerCast(replicas.value(rxName).toStrongRef()); if (rep) { static QVariant null(QMetaType::QObjectStar, (void*)0); QVariant paramValue; // Qt usually supports 9 arguments, so ten should be usually safe QVarLengthArray param(rxArgs.size() + 1); param[0] = null.data(); //Never a return value if (rxArgs.size()) { auto signal = rep->m_metaObject->method(index+rep->m_signalOffset); for (int i = 0; i < rxArgs.size(); i++) { if (signal.parameterType(i) == QMetaType::QVariant) param[i + 1] = const_cast(reinterpret_cast(&rxArgs.at(i))); else { decodeVariant(rxArgs[i], signal.parameterType(i)); param[i + 1] = const_cast(rxArgs.at(i).data()); } } } else if (propertyIndex != -1) { param.resize(2); paramValue = rep->getProperty(propertyIndex); param[1] = paramValue.data(); } qROPrivDebug() << "Replica Invoke-->" << rxName << rep->m_metaObject->method(index+rep->m_signalOffset).name() << index << rep->m_signalOffset; // We activate on rep->metaobject() so the private metacall is used, not m_metaobject (which // is the class thie replica looks like) QMetaObject::activate(rep.data(), rep->metaObject(), index+rep->m_signalOffset, param.data()); } else { //replica has been deleted, remove from list replicas.remove(rxName); } break; } case InvokeReplyPacket: { int ackedSerialId; deserializeInvokeReplyPacket(connection->stream(), ackedSerialId, rxValue); QSharedPointer rep = qSharedPointerCast(replicas.value(rxName).toStrongRef()); if (rep) { qROPrivDebug() << "Received InvokeReplyPacket ack'ing serial id:" << ackedSerialId; rep->notifyAboutReply(ackedSerialId, rxValue); } else { //replica has been deleted, remove from list replicas.remove(rxName); } break; } case AddObject: case Invalid: case Ping: qROPrivWarning() << "Unexpected packet received"; } } while (connection->bytesAvailable()); // have bytes left over, so do another iteration } /*! \class QRemoteObjectNode \inmodule QtRemoteObjects \brief A node on a Qt Remote Objects network. The QRemoteObjectNode class provides an entry point to a QtRemoteObjects network. A network can be as simple as two nodes, or an arbitrarily complex set of processes and devices. A QRemoteObjectNode does not have a url that other nodes can connect to, and thus is able to acquire replicas only. It is not able to share source objects (only QRemoteObjectHost and QRemoteObjectRegistryHost Nodes can share). Nodes may connect to each other directly using \l connectToNode, or they can use the QRemoteObjectRegistry to simplify connections. The QRemoteObjectRegistry is a special replica available to every node that connects to the Registry Url. It knows how to connect to every QRemoteObjectSource object on the network. \sa QRemoteObjectHost, QRemoteObjectRegistryHost */ /*! \class QRemoteObjectHostBase \inmodule QtRemoteObjects \brief The QRemoteObjectHostBase class provides base functionality common to \l {QRemoteObjectHost} {Host} and \l {QRemoteObjectRegistryHost} {RegistryHost} classes. QRemoteObjectHostBase is a base class that cannot be instantiated directly. It provides the enableRemoting and disableRemoting functionality shared by all host nodes (\l {QRemoteObjectHost} {Host} and \l {QRemoteObjectRegistryHost} {RegistryHost}) as well as the logic required to expose \l {Source} objects on the Remote Objects network. */ /*! \class QRemoteObjectHost \inmodule QtRemoteObjects \brief A (Host) Node on a Qt Remote Objects network. The QRemoteObjectHost class provides an entry point to a QtRemoteObjects network. A network can be as simple as two nodes, or an arbitrarily complex set of processes and devices. QRemoteObjectHosts have the same capabilities as QRemoteObjectNodes, but they can also be connected to and can share source objects on the network. Nodes may connect to each other directly using \l connectToNode, or they can use the QRemoteObjectRegistry to simplify connections. The QRemoteObjectRegistry is a special replica available to every node that connects to the uegistry Url. It knows how to connect to every QRemoteObjectSource object on the network. \sa QRemoteObjectNode, QRemoteObjectRegistryHost */ /*! \class QRemoteObjectRegistryHost \inmodule QtRemoteObjects \brief A (Host/Registry) node on a Qt Remote Objects network. The QRemoteObjectRegistryHost class provides an entry point to a QtRemoteObjects network. A network can be as simple as two Nodes, or an arbitrarily complex set of processes and devices. A QRemoteObjectRegistryHost has the same capability that a QRemoteObjectHost has (which includes everything a QRemoteObjectNode supports), and in addition is the owner of the Registry. Any QRemoteObjectHost node that connects to this Node will have all of their Source objects made available by the Registry. Nodes only support connection to one \l registry, calling \l QRemoteObjectNode::setRegistryUrl when a Registry is already set is considered an error. For something like a secure and insecure network (where different Registries would be applicable), the recommendation is to create separate Nodes to connect to each, in effect creating two independent Qt Remote Objects networks. Nodes may connect to each other directly using \l connectToNode, or they can use the QRemoteObjectRegistry to simplify connections. The QRemoteObjectRegistry is a special Replica available to every Node that connects to the Registry Url. It knows how to connect to every QRemoteObjectSource object on the network. \sa QRemoteObjectNode, QRemoteObjectHost */ /*! \enum QRemoteObjectNode::ErrorCode This enum type specifies the various error codes associated with QRemoteObjectNode errors: \value NoError No error. \value RegistryNotAcquired The registry could not be acquired. \value RegistryAlreadyHosted The registry is already defined and hosting Sources. \value NodeIsNoServer The given QRemoteObjectNode is not a host node. \value ServerAlreadyCreated The host node has already been initialized. \value UnintendedRegistryHosting An attempt was made to create a host QRemoteObjectNode and connect to itself as the registry. \value OperationNotValidOnClientNode The attempted operation is not valid on a client QRemoteObjectNode. \value SourceNotRegistered The given QRemoteObjectSource is not registered on this node. \value MissingObjectName The given QObject does not have objectName() set. \value HostUrlInvalid The given url has an invalid or unrecognized scheme. \value ProtocolMismatch The client and the server have different protocol versions. \value ListenFailed Can't listen on the specified host port. */ /*! \enum QRemoteObjectHostBase::AllowedSchemas This enum is used to specify whether a Node will accept a url with an unrecognized schema for the hostUrl. By default only urls with known schemas are accepted, but using \c AllowExternalRegistration will enable the \l Registry to pass your external (to QtRO) url to client Nodes. \value BuiltInSchemasOnly Only allow the hostUrl to be set to a QtRO supported schema. This is the default value, and causes a Node error to be set if an unrecognized schema is provided. \value AllowExternalRegistration The provided schema is registered as an \l {External Schemas}{External Schema} \sa QRemoteObjectHost */ /*! \fn ObjectType *QRemoteObjectNode::acquire(const QString &name) Returns a pointer to a Replica of type ObjectType (which is a template parameter and must inherit from \l QRemoteObjectReplica). That is, the template parameter must be a \l {repc} generated type. The \a name parameter can be used to specify the \a name given to the object during the QRemoteObjectHost::enableRemoting() call. */ void QRemoteObjectNodePrivate::initialize() { qRegisterMetaType(); qRegisterMetaType(); qRegisterMetaType(); //For queued qnx error() qRegisterMetaTypeStreamOperators >(); qRegisterMetaTypeStreamOperators(); // To support dynamic MODELs, we need to make sure the types are registered QAbstractItemModelSourceAdapter::registerTypes(); } bool QRemoteObjectNodePrivate::checkSignatures(const QByteArray &a, const QByteArray &b) { // if any of a or b is empty it means it's a dynamic ojects or an item model if (a.isEmpty() || b.isEmpty()) return true; return a == b; } void QRemoteObjectNode::persistProperties(const QString &repName, const QByteArray &repSig, const QVariantList &props) { Q_D(QRemoteObjectNode); if (d->persistedStore) { d->persistedStore->saveProperties(repName, repSig, props); } else { qCWarning(QT_REMOTEOBJECT) << qPrintable(objectName()) << "Unable to store persisted properties for" << repName; qCWarning(QT_REMOTEOBJECT) << " No persisted store set."; } } QVariantList QRemoteObjectNode::retrieveProperties(const QString &repName, const QByteArray &repSig) { Q_D(QRemoteObjectNode); if (d->persistedStore) { return d->persistedStore->restoreProperties(repName, repSig); } qCWarning(QT_REMOTEOBJECT) << qPrintable(objectName()) << "Unable to retrieve persisted properties for" << repName; qCWarning(QT_REMOTEOBJECT) << " No persisted store set."; return QVariantList(); } /*! Default constructor for QRemoteObjectNode with the given \a parent. A Node constructed in this manner can not be connected to, and thus can not expose Source objects on the network. It also will not include a \l QRemoteObjectRegistry, unless set manually using setRegistryUrl. \sa connectToNode, setRegistryUrl */ QRemoteObjectNode::QRemoteObjectNode(QObject *parent) : QObject(*new QRemoteObjectNodePrivate, parent) { Q_D(QRemoteObjectNode); d->initialize(); } /*! QRemoteObjectNode connected to a {QRemoteObjectRegistry} {Registry}. A Node constructed in this manner can not be connected to, and thus can not expose Source objects on the network. Finding and connecting to other (Host) Nodes is handled by the QRemoteObjectRegistry specified by \a registryAddress. \sa connectToNode, setRegistryUrl, QRemoteObjectHost, QRemoteObjectRegistryHost */ QRemoteObjectNode::QRemoteObjectNode(const QUrl ®istryAddress, QObject *parent) : QObject(*new QRemoteObjectNodePrivate, parent) { Q_D(QRemoteObjectNode); d->initialize(); setRegistryUrl(registryAddress); } QRemoteObjectNode::QRemoteObjectNode(QRemoteObjectNodePrivate &dptr, QObject *parent) : QObject(dptr, parent) { Q_D(QRemoteObjectNode); d->initialize(); } /*! \internal This is a base class for both QRemoteObjectHost and QRemoteObjectRegistryHost to provide the shared features/functions for sharing \l Source objects. */ QRemoteObjectHostBase::QRemoteObjectHostBase(QRemoteObjectHostBasePrivate &d, QObject *parent) : QRemoteObjectNode(d, parent) { } /*! Constructs a new QRemoteObjectHost Node (i.e., a Node that supports exposing \l Source objects on the QtRO network) with the given \a parent. This constructor is meant specific to support QML in the future as it will not be available to connect to until \l {QRemoteObjectHost::}{setHostUrl} is called. \sa setHostUrl(), setRegistryUrl() */ QRemoteObjectHost::QRemoteObjectHost(QObject *parent) : QRemoteObjectHostBase(*new QRemoteObjectHostPrivate, parent) { } /*! Constructs a new QRemoteObjectHost Node (i.e., a Node that supports exposing \l Source objects on the QtRO network) with address \a address. If set, \a registryAddress will be used to connect to the \l QRemoteObjectRegistry at the provided address. The \a allowedSchemas parameter is only needed (and should be set to \l {QRemoteObjectHostBase::AllowExternalRegistration} {AllowExternalRegistration}) if the schema of the url should be used as an \l {External Schemas} {External Schema} by the registry. \sa setHostUrl(), setRegistryUrl() */ QRemoteObjectHost::QRemoteObjectHost(const QUrl &address, const QUrl ®istryAddress, AllowedSchemas allowedSchemas, QObject *parent) : QRemoteObjectHostBase(*new QRemoteObjectHostPrivate, parent) { if (!address.isEmpty()) { if (!setHostUrl(address, allowedSchemas)) return; } if (!registryAddress.isEmpty()) setRegistryUrl(registryAddress); } /*! Constructs a new QRemoteObjectHost Node (i.e., a Node that supports exposing \l Source objects on the QtRO network) with a url of \a address and the given \a parent. This overload is provided as a convenience for specifying a QObject parent without providing a registry address. \sa setHostUrl(), setRegistryUrl() */ QRemoteObjectHost::QRemoteObjectHost(const QUrl &address, QObject *parent) : QRemoteObjectHostBase(*new QRemoteObjectHostPrivate, parent) { if (!address.isEmpty()) setHostUrl(address); } /*! \internal QRemoteObjectHost::QRemoteObjectHost */ QRemoteObjectHost::QRemoteObjectHost(QRemoteObjectHostPrivate &d, QObject *parent) : QRemoteObjectHostBase(d, parent) { } QRemoteObjectHost::~QRemoteObjectHost() {} /*! Constructs a new QRemoteObjectRegistryHost Node with the given \a parent. RegistryHost Nodes have the same functionality as \l QRemoteObjectHost Nodes, except rather than being able to connect to a \l QRemoteObjectRegistry, the provided Host QUrl (\a registryAddress) becomes the address of the registry for other Nodes to connect to. */ QRemoteObjectRegistryHost::QRemoteObjectRegistryHost(const QUrl ®istryAddress, QObject *parent) : QRemoteObjectHostBase(*new QRemoteObjectRegistryHostPrivate, parent) { if (registryAddress.isEmpty()) return; setRegistryUrl(registryAddress); } /*! \internal */ QRemoteObjectRegistryHost::QRemoteObjectRegistryHost(QRemoteObjectRegistryHostPrivate &d, QObject *parent) : QRemoteObjectHostBase(d, parent) { } QRemoteObjectRegistryHost::~QRemoteObjectRegistryHost() {} QRemoteObjectNode::~QRemoteObjectNode() { } QRemoteObjectHostBase::~QRemoteObjectHostBase() { } /*! Sets \a name as the internal name for this Node. This is then output as part of the logging (if enabled). This is primarily useful if you merge log data from multiple nodes. */ void QRemoteObjectNode::setName(const QString &name) { setObjectName(name); } /*! Similar to QObject::setObjectName() (which this method calls), but this version also applies the \a name to internal classes as well, which are used in some of the debugging output. */ void QRemoteObjectHostBase::setName(const QString &name) { Q_D(QRemoteObjectHostBase); setObjectName(name); if (d->remoteObjectIo) d->remoteObjectIo->setObjectName(name); } /*! \internal The HostBase version of this method is protected so the method isn't exposed on RegistryHost nodes. */ QUrl QRemoteObjectHostBase::hostUrl() const { Q_D(const QRemoteObjectHostBase); return d->remoteObjectIo->serverAddress(); } /*! \internal The HostBase version of this method is protected so the method isn't exposed on RegistryHost nodes. */ bool QRemoteObjectHostBase::setHostUrl(const QUrl &hostAddress, AllowedSchemas allowedSchemas) { Q_D(QRemoteObjectHostBase); if (d->remoteObjectIo) { d->setLastError(ServerAlreadyCreated); return false; } if (allowedSchemas == AllowedSchemas::BuiltInSchemasOnly && !QtROServerFactory::instance()->isValid(hostAddress)) { d->setLastError(HostUrlInvalid); return false; } if (allowedSchemas == AllowedSchemas::AllowExternalRegistration && QtROServerFactory::instance()->isValid(hostAddress)) { qWarning() << qPrintable(objectName()) << "Overriding a valid QtRO url (" << hostAddress << ") with AllowExternalRegistration is not allowed."; d->setLastError(HostUrlInvalid); return false; } d->remoteObjectIo = new QRemoteObjectSourceIo(hostAddress, this); if (allowedSchemas == AllowedSchemas::BuiltInSchemasOnly && !d->remoteObjectIo->startListening()) { d->setLastError(ListenFailed); delete d->remoteObjectIo; d->remoteObjectIo = nullptr; return false; } //If we've given a name to the node, set it on the sourceIo as well if (!objectName().isEmpty()) d->remoteObjectIo->setObjectName(objectName()); //Since we don't know whether setHostUrl or setRegistryUrl/setRegistryHost will be called first, //break it into two pieces. setHostUrl connects the RemoteObjectSourceIo->[add/remove]RemoteObjectSource to QRemoteObjectReplicaNode->[add/remove]RemoteObjectSource //setRegistry* calls appropriately connect RemoteObjecSourcetIo->[add/remove]RemoteObjectSource to the registry when it is created QObject::connect(d->remoteObjectIo, &QRemoteObjectSourceIo::remoteObjectAdded, this, &QRemoteObjectHostBase::remoteObjectAdded); QObject::connect(d->remoteObjectIo, &QRemoteObjectSourceIo::remoteObjectRemoved, this, &QRemoteObjectHostBase::remoteObjectRemoved); return true; } /*! Returns the host address for the QRemoteObjectNode as a QUrl. If the Node is not a Host node, it return an empty QUrl. \sa setHostUrl() */ QUrl QRemoteObjectHost::hostUrl() const { return QRemoteObjectHostBase::hostUrl(); } /*! Sets the \a hostAddress for a host QRemoteObjectNode. Returns \c true if the Host address is set, otherwise \c false. The \a allowedSchemas parameter is only needed (and should be set to \l {QRemoteObjectHostBase::AllowExternalRegistration} {AllowExternalRegistration}) if the schema of the url should be used as an \l {External Schemas} {External Schema} by the registry. */ bool QRemoteObjectHost::setHostUrl(const QUrl &hostAddress, AllowedSchemas allowedSchemas) { return QRemoteObjectHostBase::setHostUrl(hostAddress, allowedSchemas); } /*! This method can be used to set the address of this Node to \a registryUrl (used for other Nodes to connect to this one), if the QUrl isn't set in the constructor. Since this Node becomes the Registry, calling this setter method causes this Node to use the url as the host address. All other Node's use the \l {QRemoteObjectNode::setRegistryUrl} method initiate a connection to the Registry. Returns \c true if the registry address is set, otherwise \c false. \sa QRemoteObjectRegistryHost(), QRemoteObjectNode::setRegistryUrl */ bool QRemoteObjectRegistryHost::setRegistryUrl(const QUrl ®istryUrl) { Q_D(QRemoteObjectRegistryHost); if (setHostUrl(registryUrl)) { if (!d->remoteObjectIo) { d->setLastError(ServerAlreadyCreated); return false; } else if (d->registry) { d->setLastError(RegistryAlreadyHosted); return false; } QRegistrySource *remoteObject = new QRegistrySource(this); enableRemoting(remoteObject); d->registryAddress = d->remoteObjectIo->serverAddress(); d->registrySource = remoteObject; //Connect RemoteObjectSourceIo->remoteObject[Added/Removde] to the registry Slot QObject::connect(this, &QRemoteObjectRegistryHost::remoteObjectAdded, d->registrySource, &QRegistrySource::addSource); QObject::connect(this, &QRemoteObjectRegistryHost::remoteObjectRemoved, d->registrySource, &QRegistrySource::removeSource); QObject::connect(d->remoteObjectIo, &QRemoteObjectSourceIo::serverRemoved,d->registrySource, &QRegistrySource::removeServer); //onAdd/Remove update the known remoteObjects list in the RegistrySource, so no need to connect to the RegistrySource remoteObjectAdded/Removed signals d->setRegistry(acquire()); return true; } return false; } /*! Returns the last error set. */ QRemoteObjectNode::ErrorCode QRemoteObjectNode::lastError() const { Q_D(const QRemoteObjectNode); return d->lastError; } /*! \qmlproperty url Node::registryUrl The address of the \l {QRemoteObjectRegistry} {Registry} used by this node. This is an empty QUrl if there is no registry in use. */ /*! \property QRemoteObjectNode::registryUrl \brief The address of the \l {QRemoteObjectRegistry} {Registry} used by this node. This is an empty QUrl if there is no registry in use. */ QUrl QRemoteObjectNode::registryUrl() const { Q_D(const QRemoteObjectNode); return d->registryAddress; } bool QRemoteObjectNode::setRegistryUrl(const QUrl ®istryAddress) { Q_D(QRemoteObjectNode); if (d->registry) { d->setLastError(RegistryAlreadyHosted); return false; } d->registryAddress = registryAddress; d->setRegistry(acquire()); //Connect remoteObject[Added/Removed] to the registry Slot QObject::connect(this, &QRemoteObjectNode::remoteObjectAdded, d->registry, &QRemoteObjectRegistry::addSource); QObject::connect(this, &QRemoteObjectNode::remoteObjectRemoved, d->registry, &QRemoteObjectRegistry::removeSource); connectToNode(registryAddress); return true; } void QRemoteObjectNodePrivate::setRegistry(QRemoteObjectRegistry *reg) { Q_Q(QRemoteObjectNode); registry = reg; reg->setParent(q); //Make sure when we get the registry initialized, we update our replicas QObject::connect(reg, &QRemoteObjectRegistry::initialized, q, [this]() { onRegistryInitialized(); }); //Make sure we handle new RemoteObjectSources on Registry... QObject::connect(reg, &QRemoteObjectRegistry::remoteObjectAdded, q, [this](const QRemoteObjectSourceLocation &location) { onRemoteObjectSourceAdded(location); }); QObject::connect(reg, &QRemoteObjectRegistry::remoteObjectRemoved, q, [this](const QRemoteObjectSourceLocation &location) { onRemoteObjectSourceRemoved(location); }); } QVariant QRemoteObjectNodePrivate::handlePointerToQObjectProperty(QConnectedReplicaImplementation *rep, int index, const QVariant &property) { Q_Q(QRemoteObjectNode); using namespace QRemoteObjectPackets; QVariant retval; Q_ASSERT(property.canConvert()); QRO_ childInfo = property.value(); qROPrivDebug() << "QRO_:" << childInfo.name << replicas.contains(childInfo.name) << replicas.keys(); if (childInfo.isNull) { // Either the source has changed the pointer and we need to update it, or the source pointer is a nullptr if (replicas.contains(childInfo.name)) replicas.remove(childInfo.name); if (childInfo.type == ObjectType::CLASS) retval = QVariant::fromValue(nullptr); else retval = QVariant::fromValue(nullptr); return retval; } const bool newReplica = !replicas.contains(childInfo.name) || rep->isInitialized(); if (newReplica) { if (rep->isInitialized()) { auto childRep = qSharedPointerCast(replicas.take(childInfo.name)); if (childRep && !childRep->isShortCircuit()) { qCDebug(QT_REMOTEOBJECT) << "Checking if dynamic type should be added to dynamicTypeManager (type =" << childRep->m_metaObject->className() << ")"; dynamicTypeManager.addFromMetaObject(childRep->m_metaObject); } } if (childInfo.type == ObjectType::CLASS) retval = QVariant::fromValue(q->acquireDynamic(childInfo.name)); else retval = QVariant::fromValue(q->acquireModel(childInfo.name)); } else //We are receiving the initial data for the QObject retval = rep->getProperty(index); //Use existing value so changed signal isn't emitted QSharedPointer childRep = qSharedPointerCast(replicas.value(childInfo.name).toStrongRef()); if (childRep->connectionToSource.isNull()) childRep->connectionToSource = rep->connectionToSource; QVariantList parameters; QDataStream ds(childInfo.parameters); if (childRep->needsDynamicInitialization()) { if (childInfo.classDefinition.isEmpty()) { auto typeName = childInfo.typeName; if (typeName == QLatin1String("QObject")) { // The sender would have included the class name if needed // So the acquire must have been templated, and we have the typeName typeName = QString::fromLatin1(rep->getProperty(index).typeName()); if (typeName.endsWith(QLatin1String("Replica*"))) typeName.chop(8); } childRep->setDynamicMetaObject(dynamicTypeManager.metaObjectForType(typeName)); } else { QDataStream in(childInfo.classDefinition); childRep->setDynamicMetaObject(dynamicTypeManager.addDynamicType(rep->connectionToSource, in)); } if (!childInfo.parameters.isEmpty()) ds >> parameters; handlePointerToQObjectProperties(childRep.data(), parameters); childRep->setDynamicProperties(parameters); } else { if (!childInfo.parameters.isEmpty()) ds >> parameters; handlePointerToQObjectProperties(childRep.data(), parameters); childRep->initialize(parameters); } return retval; } void QRemoteObjectNodePrivate::handlePointerToQObjectProperties(QConnectedReplicaImplementation *rep, QVariantList &properties) { for (const int index : rep->childIndices()) properties[index] = handlePointerToQObjectProperty(rep, index, properties.at(index)); } /*! Blocks until this Node's \l Registry is initialized or \a timeout (in milliseconds) expires. Returns \c true if the \l Registry is successfully initialized upon return, or \c false otherwise. */ bool QRemoteObjectNode::waitForRegistry(int timeout) { Q_D(QRemoteObjectNode); if (!d->registry) { qCWarning(QT_REMOTEOBJECT) << qPrintable(objectName()) << "waitForRegistry() error: No valid registry url set"; return false; } return d->registry->waitForSource(timeout); } /*! Connects a client node to the host node at \a address. Connections will remain valid until the host node is deleted or no longer accessible over a network. Once a client is connected to a host, valid Replicas can then be acquired if the corresponding Source is being remoted. Return \c true on success, \c false otherwise (usually an unrecognized url, or connecting to already connected address). */ bool QRemoteObjectNode::connectToNode(const QUrl &address) { Q_D(QRemoteObjectNode); if (!d->initConnection(address)) { d->setLastError(RegistryNotAcquired); return false; } return true; } /*! \since 5.12 In order to \l QRemoteObjectNode::acquire() \l Replica objects over \l {External QIODevices}, Qt Remote Objects needs access to the communications channel (a \l QIODevice) between the respective nodes. It is the addClientSideConnection() call that enables this, taking the \a ioDevice as input. Any acquire() call made without calling addClientSideConnection will still work, but the Node will not be able to initialize the \l Replica without being provided the connection to the Host node. \sa {QRemoteObjectHostBase::addHostSideConnection} */ void QRemoteObjectNode::addClientSideConnection(QIODevice *ioDevice) { Q_D(QRemoteObjectNode); ExternalIoDevice *device = new ExternalIoDevice(ioDevice, this); connect(device, &IoDeviceBase::readyRead, this, [d, device]() { d->onClientRead(device); }); if (device->bytesAvailable()) d->onClientRead(device); } /*! \fn void QRemoteObjectNode::remoteObjectAdded(const QRemoteObjectSourceLocation &loc) This signal is emitted whenever a new \l {Source} object is added to the Registry. The signal will not be emitted if there is no Registry set (i.e., Sources over connections made via connectToNode directly). The \a loc parameter contains the information about the added Source, including name, type and the QUrl of the hosting Node. \sa remoteObjectRemoved(), instances() */ /*! \fn void remoteObjectRemoved(const QRemoteObjectSourceLocation &loc) This signal is emitted whenever there is a known \l {Source} object is removed from the Registry. The signal will not be emitted if there is no Registry set (i.e., Sources over connections made via connectToNode directly). The \a loc parameter contains the information about the removed Source, including name, type and the QUrl of the hosting Node. \sa remoteObjectAdded, instances */ /*! \fn QStringList QRemoteObjectNode::instances() const This templated function (taking a \l repc generated type as the template parameter) will return the list of names of every instance of that type on the Remote Objects network. For example, if you have a Shape class defined in a .rep file, and Circle and Square classes inherit from the Source definition, they can be shared on the Remote Objects network using \l {QRemoteObjectHostBase::enableRemoting} {enableRemoting}. \code Square square; Circle circle; myHost.enableRemoting(&square, "Square"); myHost.enableRemoting(&circle, "Circle"); \endcode Then instance can be used to find the available instances of Shape. \code QStringList instances = clientNode.instances(); // will return a QStringList containing "Circle" and "Square" auto instance1 = clientNode.acquire("Circle"); auto instance2 = clientNode.acquire("Square"); ... \endcode */ /*! \overload instances() This convenience function provides the same result as the templated version, but takes the name of the \l {Source} class as a parameter (\a typeName) rather than deriving it from the class type. */ QStringList QRemoteObjectNode::instances(const QString &typeName) const { Q_D(const QRemoteObjectNode); QStringList names; for (auto it = d->connectedSources.cbegin(), end = d->connectedSources.cend(); it != end; ++it) { if (it.value().typeName == typeName) { names << it.key(); } } return names; } /*! \keyword dynamic acquire Returns a QRemoteObjectDynamicReplica of the Source \a name. */ QRemoteObjectDynamicReplica *QRemoteObjectNode::acquireDynamic(const QString &name) { return new QRemoteObjectDynamicReplica(this, name); } /*! Enables a host node to dynamically provide remote access to the QObject \a object. Client nodes connected to the node hosting this object may obtain Replicas of this Source. The \a name defines the lookup-name under which the QObject can be acquired using \l QRemoteObjectNode::acquire() . If not explicitly set then the name given in the QCLASSINFO_REMOTEOBJECT_TYPE will be used. If no such macro was defined for the QObject then the \l QObject::objectName() is used. Returns \c false if the current node is a client node, or if the QObject is already registered to be remoted, and \c true if remoting is successfully enabled for the dynamic QObject. \sa disableRemoting() */ bool QRemoteObjectHostBase::enableRemoting(QObject *object, const QString &name) { Q_D(QRemoteObjectHostBase); if (!d->remoteObjectIo) { d->setLastError(OperationNotValidOnClientNode); return false; } const QMetaObject *meta = object->metaObject(); QString _name = name; QString typeName = getTypeNameAndMetaobjectFromClassInfo(meta); if (typeName.isEmpty()) { //This is a passed in QObject, use its API if (_name.isEmpty()) { _name = object->objectName(); if (_name.isEmpty()) { d->setLastError(MissingObjectName); qCWarning(QT_REMOTEOBJECT) << qPrintable(objectName()) << "enableRemoting() Error: Unable to Replicate an object that does not have objectName() set."; return false; } } } else if (_name.isEmpty()) _name = typeName; return d->remoteObjectIo->enableRemoting(object, meta, _name, typeName); } /*! This overload of enableRemoting() is specific to \l QAbstractItemModel types (or any type derived from \l QAbstractItemModel). This is useful if you want to have a model and the HMI for the model in different processes. The three required parameters are the \a model itself, the \a name by which to lookup the model, and the \a roles that should be exposed on the Replica side. If you want to synchronize selection between \l Source and \l Replica, the optional \a selectionModel parameter can be used. This is only recommended when using a single Replica. Behind the scenes, Qt Remote Objects batches data() lookups and prefetches data when possible to make the model interaction as responsive as possible. Returns \c false if the current node is a client node, or if the QObject is already registered to be remoted, and \c true if remoting is successfully enabled for the QAbstractItemModel. \sa disableRemoting() */ bool QRemoteObjectHostBase::enableRemoting(QAbstractItemModel *model, const QString &name, const QVector roles, QItemSelectionModel *selectionModel) { //This looks complicated, but hopefully there is a way to have an adapter be a template //parameter and this makes sure that is supported. QObject *adapter = QAbstractItemModelSourceAdapter::staticMetaObject.newInstance(Q_ARG(QAbstractItemModel*, model), Q_ARG(QItemSelectionModel*, selectionModel), Q_ARG(QVector, roles)); QAbstractItemAdapterSourceAPI *api = new QAbstractItemAdapterSourceAPI(name); if (!this->objectName().isEmpty()) adapter->setObjectName(this->objectName().append(QLatin1String("Adapter"))); return enableRemoting(model, api, adapter); } /*! \fn template