Qt Remote Objects Fuente
A grandes rasgos, puedes optar por utilizar directamente un tipo « QObject » como fuente; o bien, puedes definir la API deseada en una plantilla « .rep » para utilizarla con el compilador repc.
Si ya dispone de un ` QObject` completamente definido, puede utilizarlo como fuente pasándolo a ` QRemoteObjectHostBase::enableRemoting()`. De este modo, otros procesos o dispositivos podrán crear ` dynamics replicas ` del objeto con el que interactuar.
Para obtener más información, consulta Interacción con objetos remotos.
Al permitir que repc genere un archivo de encabezado de código fuente para tu proyecto, utilizando la variable REPC_SOURCE, se ofrecen tres opciones diferentes para implementar la API requerida.
Supongamos que el nombre de tu clase es «Foo»; en ese caso, dispones de las siguientes opciones:
- Herencia deFooSimpleSource
- Herencia de `FooSource `
- Uso de«FooSourceAPI » con tu propio QObject
Para obtener más detalles sobre cómo crear un archivo « .rep », consulta «El formato de archivo rep».
En el encabezado hay definida una clase <Type>SimpleSource, que proporciona los métodos getter/setter básicos para cada propiedad e implementa los miembros de datos del tipo de propiedad correcto en el encabezado. «<Type>» representa aquí el nombre de la clase del archivo .rep, por lo que, si su clase es de tipo «MyType» en el archivo .rep, el archivo de cabecera generado tendrá declarada una clase MyTypeSimpleSource. Esta es una forma rápida de empezar a utilizar la API. Para utilizar esta clase, debes escribir una clase que herede de ella e implementar las ranuras definidas, que están marcadas como puramente virtuales en el archivo de cabecera generado. También debes añadir a tu clase la lógica necesaria para gestionar las propiedades expuestas y emitir señales.
Si necesitas ocultar los detalles de tu implementación, utiliza la segunda clase declarada en el archivo de cabecera: la clase <Type>Source. La definición de esta clase no proporciona miembros de datos y, además, hace que las funciones getter/setter sean puramente virtuales. Aunque quizá tengas que escribir más código, el uso de esta clase te ofrece mayor flexibilidad en tu implementación.
La tercera clase generada en el encabezado es <Type>SourceAPI. Se trata de una clase basada en plantillas, destinada específicamente a la versión basada en plantillas de ` QRemoteObjectHostBase::enableRemoting()`, que te permite utilizar como fuente cualquier ` QObject ` que admita la API requerida. Utiliza esta clase para ocultar o convertir propiedades o parámetros de señales y ranuras. Si su implementación no proporciona la API correcta, aparecerán advertencias en tiempo de compilación.
Nota: Tantolas réplicas como las fuentes derivan de QObject; sin embargo, su API QObject nunca queda expuesta. Por ejemplo, aunque una réplica tenga una señal destroyed, la señal destroyed de la fuente no se propaga. La fuente y cada una de sus réplicas son objetos QObject únicos con sus propias conexiones y ciclos de vida. En su lugar, la API que se expone viene definida por la plantilla .rep utilizada por repc. En el caso de los QObjects sin procesar, todos los elementos de la API se definen en la cadena de herencia a partir de un antepasado específico. Siempre se utiliza el padre de QObject, a menos que se defina Q_CLASSINFO("RemoteObject Type") en un antepasado. Si se utiliza Q_CLASSINFO("RemoteObject Type"), la API de esa clase es el nivel más bajo de API utilizado.
Identificación de fuentes
Dado que un nodo anfitrión puede compartir más de una fuente, cada fuente requiere un nombre. Todas las cabeceras generadas por repc incluyen una forma para que el nodo determine el nombre de la clase: Q_CLASSINFO para los tipos «replica», «simplesource» o «source»; o una función estática name() para el tipo «SourceAPI». Si pasas tu propio tipo « QObject » a QRemoteObjectHostBase::enableRemoting(), el nombre se determina utilizando la siguiente lógica:
- Opcionalmente, se puede pasar un nombre a QRemoteObjectHostBase::enableRemoting(). Si se proporciona, se utiliza ese nombre.
- Si el objeto o cualquiera de sus antecesores tiene definido un ` Q_CLASSINFO ` de tipo «RemoteObject Type», se utiliza ese nombre de tipo.
- Si se ha establecido el «objectName» de « QObject », se utiliza este.
- Si ninguna de las opciones anteriores está disponible, la llamada a ` QRemoteObjectHostBase::enableRemoting()` falla y devuelve `false`.
© 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.