QRemoteObjectNode Class

Documentation des fonctions membres

QRemoteObjectNode::QRemoteObjectNode(QObject *parent = nullptr)

Constructeur par défaut pour QRemoteObjectNode avec l'parent donné. Un nœud construit de cette manière ne peut pas être connecté et ne peut donc pas exposer d'objets Source sur le réseau. Il n'inclura pas non plus de QRemoteObjectRegistry, à moins que celui-ci ne soit défini manuellement à l'aide de setRegistryUrl.

Voir également connectToNode et setRegistryUrl.

QRemoteObjectNode::QRemoteObjectNode(const QUrl &registryAddress, QObject *parent = nullptr)

QRemoteObjectNode connecté à un {QRemoteObjectRegistry} {Registry}. Un nœud construit de cette manière ne peut pas être connecté et ne peut donc pas exposer d’objets Source sur le réseau. La recherche et la connexion à d’autres nœuds (hôtes) sont gérées par l’ QRemoteObjectRegistry, tel que spécifié par registryAddress.

Voir également connectToNode, setRegistryUrl, QRemoteObjectHost et QRemoteObjectRegistryHost.

template <typename ObjectType> ObjectType *QRemoteObjectNode::acquire(const QString &name = QString())

Renvoie un pointeur vers une réplique de type `ObjectType` (qui est un paramètre de modèle et doit hériter de ` QRemoteObjectReplica`). Autrement dit, le paramètre de modèle doit être un type généré par repc. Le paramètre ` name ` peut être utilisé pour spécifier l'name e attribuée à l'objet lors de l'appel à ` QRemoteObjectHost::enableRemoting()`.

QRemoteObjectDynamicReplica *QRemoteObjectNode::acquireDynamic(const QString &name)

Renvoie un objet « QRemoteObjectDynamicReplica » de l'name «Source».

QAbstractItemModelReplica *QRemoteObjectNode::acquireModel(const QString &name, QtRemoteObjects::InitialAction action = QtRemoteObjects::FetchRootSize, const QList<int> &rolesHint = {})

Renvoie un pointeur vers une réplique dérivée spécifiquement de QAbstractItemModel. L'name fournie doit correspondre au nom utilisé avec l'enableRemoting correspondant qui a mis le modèle sur le réseau. action spécifie si le modèle doit récupérer des données avant l'émission du signal initialized. S'il est défini sur QtRemoteObjects::PrefetchData, les données relatives aux rôles de l'rolesHint seront préchargées. Si rolesHint est vide, les données de tous les rôles exposés par Source seront préchargées.

Le modèle renvoyé sera vide jusqu’à ce qu’il soit initialisé avec Source.

void QRemoteObjectNode::addClientSideConnection(QIODevice *ioDevice)

Pour pouvoir utiliser la fonction ` QRemoteObjectNode::acquire()` sur des objets `Replica` via des périphériques QIODevices externes, ` Qt Remote Objects ` doit avoir accès au canal de communication (un ` QIODevice`) entre les nœuds concernés. C’est l’appel à la fonction `addClientSideConnection()` qui permet cela, en prenant l’objet ` ioDevice ` en paramètre. Tout appel à ` acquire()` effectué sans appeler `addClientSideConnection` fonctionnera tout de même, mais le nœud ne pourra pas initialiser la réplique sans que la connexion au nœud hôte lui soit fournie.

Voir également QRemoteObjectHostBase::addHostSideConnection.

[invokable] bool QRemoteObjectNode::connectToNode(const QUrl &address)

Permet de connecter un nœud client au nœud hôte à l'adresse address.

Les connexions resteront valides jusqu’à ce que le nœud hôte soit supprimé ou ne soit plus accessible via le réseau.

Une fois qu’un client est connecté à un hôte, des répliques valides peuvent alors être obtenues si la source correspondante est accessible à distance.

Renvoie true en cas de succès, false dans le cas contraire (généralement une URL non reconnue ou une tentative de connexion à une adresse déjà connectée).

template <typename T> QStringList QRemoteObjectNode::instances() const

Cette fonction de modèle (qui prend un type généré par repc comme paramètre de modèle) renvoie la liste des noms de toutes les instances de ce type sur le réseau Remote Objects. Par exemple, si vous avez défini une classe `Shape` dans un fichier .rep, et que les classes `Circle` et `Square` héritent de la définition `Source`, elles peuvent être partagées sur le réseau Remote Objects à l'aide de ` enableRemoting`.

Square square;
Circle circle;
myHost.enableRemoting(&square, "Square");
myHost.enableRemoting(&circle, "Circle");

La fonction `instance` peut alors être utilisée pour trouver les instances disponibles de `Shape`.

QStringList instances = clientNode.instances<Shape>();
// will return a QStringList containing "Circle" and "Square"
auto instance1 = clientNode.acquire<Shape>("Circle");
auto instance2 = clientNode.acquire<Shape>("Square");
...

QStringList QRemoteObjectNode::instances(QStringView typeName) const

Cette fonction de commodité fournit le même résultat que la version avec modèle, mais prend le nom de la classe Source comme paramètre (typeName) au lieu de le dériver du type de classe.

QRemoteObjectNode::ErrorCode QRemoteObjectNode::lastError() const

Renvoie le dernier ensemble d'erreurs.

[signal, since 6.12] void QRemoteObjectNode::persistedStoreChanged(QRemoteObjectAbstractPersistedStore *persistedStore)

Ce signal est émis lorsque la propriété « persistedStore » passe à la valeur « persistedStore ».

Cette fonction a été introduite dans Qt 6.12.

void QRemoteObjectNode::registerExternalSchema(const QString &schema, QRemoteObjectNode::RemoteObjectSchemaHandler handler)

Fournir une méthode personnalisée pour gérer les schémas fournis en externe

Cette méthode est liée au registre et aux schémas externes. En enregistrant un gestionnaire de type std::function pour un schéma externe, la méthode enregistrée sera appelée lorsque le registre sera informé de la disponibilité d'une source que vous avez acquise. Sans cet enregistrement, QtRO ne pourrait gérer que les schémas « intégrés ».

La méthode fournie, handler, sera appelée lorsque le registre détectera un objet Source sur un nouveau nœud (non encore connecté) dont le {QUrl::schema()} est schema. L’ handler, de type QRemoteObjectNode::RemoteObjectSchemaHandler, recevra en paramètre d’entrée l’ QUrl du nœud fournissant la source et sera chargé d’établir le canal de communication (une sorte de QIODevice ) et d’appeler addClientSideConnection avec celui-ci.

Voir également RemoteObjectSchemaHandler.

const QRemoteObjectRegistry *QRemoteObjectNode::registry() const

Renvoie un pointeur vers l'QRemoteObjectRegistry du nœud, si celui-ci utilise la fonctionnalité Registry ; sinon, il renvoie nullptr.

[signal, since 6.12] void QRemoteObjectNode::registryUrlChanged(const QUrl &registryUrl)

Ce signal est émis lorsque la propriété « registryUrl » passe à la valeur « registryUrl ».

Cette fonction a été introduite dans Qt 6.12.

[signal] void QRemoteObjectNode::remoteObjectAdded(const QRemoteObjectSourceLocation &loc)

Ce signal est émis chaque fois qu’un nouvel objet Source est ajouté au registre. Le signal ne sera pas émis s’il n’y a pas de registre défini (c’est-à-dire pour les sources via des connexions établies directement via connectToNode ). Le paramètre loc contient les informations relatives à la Source ajoutée, notamment son nom, son type et l’ QUrl du nœud hôte.

Voir également remoteObjectRemoved() et instances().

[signal] void QRemoteObjectNode::remoteObjectRemoved(const QRemoteObjectSourceLocation &loc)

Ce signal est émis chaque fois qu'un objet Source connu est supprimé du registre. Le signal ne sera pas émis s'il n'y a pas de registre défini (c'est-à-dire pour les Sources établies via des connexions directes à l'adresse connectToNode ). Le paramètre loc contient les informations relatives à la Source supprimée, notamment son nom, son type et l'QUrl du nœud hébergeant celle-ci.

Voir également remoteObjectAdded et instances.

[virtual] void QRemoteObjectNode::setName(const QString &name)

Définit « name » comme nom interne de ce nœud. Ce nom apparaît ensuite dans les journaux (si cette fonctionnalité est activée). Cette option est particulièrement utile lorsque vous fusionnez les données de journalisation provenant de plusieurs nœuds.

[override virtual protected] void QRemoteObjectNode::timerEvent(QTimerEvent *)

Réimplémente : QObject::timerEvent(QTimerEvent *event).

bool QRemoteObjectNode::waitForRegistry(int timeout = 30000)

Bloque jusqu’à ce que le registre de ce nœud soit initialisé ou que le délai d’ timeout ation (en millisecondes) expire. Renvoie true si le registre a été initialisé avec succès au moment du retour, ou false dans le cas contraire.