Qt Remote Objects Réplica
Una réplica compilada es un tipo basado en « QRemoteObjectReplica », en el que la definición de la clase derivada se genera automáticamente mediante el compilador repc. Cuando se utilizan funciones de CMake o variables de qmake para ejecutar el compilador repc, la generación pasa a formar parte del proceso de compilación. Aunque solo se genera un archivo de cabecera, se trata de un tipo completo. No hay ningún constructor público, por lo que es necesario utilizar la función de plantilla ` QRemoteObjectNode::acquire ` para crear la instancia de `Replica`.
Se puede generar una réplica dinámica ( QRemoteObjectDynamicReplica ) en tiempo de ejecución. Para ello, se llama a ` QRemoteObjectNode::acquireDynamic()`, pasando el nombre de la fuente (un ` QString`) como argumento. Las réplicas dinámicas son un poco más prolijas de usar desde C++, pero no requieren compilación. Las réplicas dinámicas no admiten valores iniciales de propiedades ni introspección hasta que se hayan inicializado.
Una diferencia importante entre estas dos formas de crear réplicas es el comportamiento antes de que la réplica se inicialice. Dado que una réplica dinámica solo obtiene un metaObject tras la inicialización, básicamente no dispone de API antes de la inicialización: no tiene propiedades ni señales a las que conectar slots.
Dado que los metaObjects de las réplicas compiladas se crean en tiempo de compilación, su API está disponible cuando se instancia la réplica. Incluso se pueden proporcionar valores por defecto para las propiedades en el archivo de plantilla, que se utilizan hasta que la réplica se inicializa con los valores actuales del código fuente.
Inicialización de la réplica
Un nodo anfitrión compartirá la lista de fuentes que aloja con todos los demás nodos que se conecten a él. Este nodo anfitrión envía actualizaciones cuando se añaden o se eliminan fuentes de la lista. De este modo, un nodo conectado sabrá en todo momento a qué fuentes puede conectarse. Los cambios en una fuente concreta solo se propagan a los nodos que tienen una réplica de dicha fuente. En consecuencia, esto evita cualquier tráfico de red innecesario.
Cuando un nodo adquiere una réplica de una fuente conocida, envía una solicitud de dicha fuente al nodo anfitrión. Al recibir esta solicitud, el nodo anfitrión crea un paquete de respuesta con los valores actuales de todas las propiedades de esa fuente. Si la réplica solicitada es de tip dynamic, el paquete de respuesta incluye la definición de la API de la fuente. A partir de ese momento, el nodo de la réplica se incluirá en la lista de conexiones que reciben los cambios de esa fuente.
Si se instancia una réplica pero su nodo no está conectado al nodo que aloja la fuente solicitada —o si ese objeto reside en un proceso del nodo host, pero no se ha habilitado el uso compartido o el acceso remoto para QObject —, la réplica se creará de todos modos, pero permanecerá sin inicializar.
Si, más adelante, el nodo de la réplica recibe una notificación de que la fuente solicitada está disponible desde un nodo conectado, en ese momento solicitará la fuente e iniciará el proceso de inicialización.
Si se pierde la conexión con un nodo anfitrión, la réplica pasará al estado «inválido». Intentará volver a conectarse y se reinicializará si se restablece la conexión; esto garantiza que todas las propiedades estén actualizadas.
Propiedad de la réplica
Los métodos de adquisición devuelven un puntero a la réplica QObject instanciada por el nodo. El nodo no tiene forma de conocer la vida útil prevista de la réplica. Por consiguiente, cuando la réplica ya no sea necesaria, es responsabilidad del programa que la invoca eliminarla.
Se pueden instanciar varias copias de la misma réplica. Todas las réplicas de la misma fuente procedentes de un único nodo compartirán un miembro de datos privado que gestiona la comunicación de red. Esto significa que varias instancias de una réplica no generan tráfico de red adicional, aunque sí supondrán una sobrecarga de procesamiento adicional. Si no se eliminan las réplicas, se impedirá que el recuento de referencias de este objeto privado llegue a 0, lo que provocará una comunicación de red innecesaria hasta que el proceso que realiza la llamada finalice. Por este motivo, se recomienda utilizar QScopedPointer o QSharedPointer para ayudar a realizar un seguimiento del tiempo de vida de las réplicas.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.