// Copyright (C) 2017 Ford Motor Company // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only #ifndef QREMOTEOBJECTNODE_H #define QREMOTEOBJECTNODE_H #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE class QRemoteObjectReplica; class SourceApiMap; class QAbstractItemModel; class QAbstractItemModelReplica; class QItemSelectionModel; class QRemoteObjectAbstractPersistedStorePrivate; class QRemoteObjectNodePrivate; class QRemoteObjectHostBasePrivate; class QRemoteObjectHostPrivate; class QRemoteObjectRegistryHostPrivate; class Q_REMOTEOBJECTS_EXPORT QRemoteObjectAbstractPersistedStore : public QObject { Q_OBJECT public: QRemoteObjectAbstractPersistedStore (QObject *parent = nullptr); virtual ~QRemoteObjectAbstractPersistedStore(); virtual void saveProperties(const QString &repName, const QByteArray &repSig, const QVariantList &values) = 0; virtual QVariantList restoreProperties(const QString &repName, const QByteArray &repSig) = 0; protected: QRemoteObjectAbstractPersistedStore(QRemoteObjectAbstractPersistedStorePrivate &, QObject *parent); Q_DECLARE_PRIVATE(QRemoteObjectAbstractPersistedStore) }; class Q_REMOTEOBJECTS_EXPORT QRemoteObjectNode : public QObject { Q_OBJECT Q_PROPERTY(QUrl registryUrl READ registryUrl WRITE setRegistryUrl) Q_PROPERTY(QRemoteObjectAbstractPersistedStore* persistedStore READ persistedStore WRITE setPersistedStore) Q_PROPERTY(int heartbeatInterval READ heartbeatInterval WRITE setHeartbeatInterval NOTIFY heartbeatIntervalChanged) public: enum ErrorCode{ NoError, RegistryNotAcquired, RegistryAlreadyHosted, NodeIsNoServer, ServerAlreadyCreated, UnintendedRegistryHosting, OperationNotValidOnClientNode, SourceNotRegistered, MissingObjectName, HostUrlInvalid, ProtocolMismatch, ListenFailed, SocketAccessError }; Q_ENUM(ErrorCode) QRemoteObjectNode(QObject *parent = nullptr); QRemoteObjectNode(const QUrl ®istryAddress, QObject *parent = nullptr); ~QRemoteObjectNode() override; Q_INVOKABLE bool connectToNode(const QUrl &address); void addClientSideConnection(QIODevice *ioDevice); virtual void setName(const QString &name); template < class ObjectType > ObjectType *acquire(const QString &name = QString()) { return new ObjectType(this, name); } template QStringList instances() const { const QMetaObject *mobj = &T::staticMetaObject; const int index = mobj->indexOfClassInfo(QCLASSINFO_REMOTEOBJECT_TYPE); if (index == -1) return QStringList(); const QString typeName = QString::fromLatin1(mobj->classInfo(index).value()); return instances(typeName); } QStringList instances(QStringView typeName) const; QRemoteObjectDynamicReplica *acquireDynamic(const QString &name); QAbstractItemModelReplica *acquireModel(const QString &name, QtRemoteObjects::InitialAction action = QtRemoteObjects::FetchRootSize, const QList &rolesHint = {}); QUrl registryUrl() const; virtual bool setRegistryUrl(const QUrl ®istryAddress); bool waitForRegistry(int timeout = 30000); const QRemoteObjectRegistry *registry() const; QRemoteObjectAbstractPersistedStore *persistedStore() const; void setPersistedStore(QRemoteObjectAbstractPersistedStore *persistedStore); ErrorCode lastError() const; int heartbeatInterval() const; void setHeartbeatInterval(int interval); typedef std::function RemoteObjectSchemaHandler; void registerExternalSchema(const QString &schema, RemoteObjectSchemaHandler handler); Q_SIGNALS: void remoteObjectAdded(const QRemoteObjectSourceLocation &); void remoteObjectRemoved(const QRemoteObjectSourceLocation &); void error(QRemoteObjectNode::ErrorCode errorCode); void heartbeatIntervalChanged(int heartbeatInterval); protected: QRemoteObjectNode(QRemoteObjectNodePrivate &, QObject *parent); void timerEvent(QTimerEvent*) override; private: void initializeReplica(QRemoteObjectReplica *instance, const QString &name = QString()); void persistProperties(const QString &repName, const QByteArray &repSig, const QVariantList &props); QVariantList retrieveProperties(const QString &repName, const QByteArray &repSig); Q_DECLARE_PRIVATE(QRemoteObjectNode) friend class QRemoteObjectReplica; friend class QConnectedReplicaImplementation; }; class Q_REMOTEOBJECTS_EXPORT QRemoteObjectHostBase : public QRemoteObjectNode { Q_OBJECT public: enum AllowedSchemas { BuiltInSchemasOnly, AllowExternalRegistration }; Q_ENUM(AllowedSchemas) ~QRemoteObjectHostBase() override; void setName(const QString &name) override; template