Uso de adaptadores de « Qt D-Bus »

Los adaptadores son clases especiales que se asocian a cualquier clase derivada de ` QObject` y proporcionan la interfaz con el mundo exterior mediante D-Bus. Los adaptadores están concebidos como clases ligeras cuyo objetivo principal es retransmitir llamadas hacia y desde el objeto real, posiblemente validando o convirtiendo la entrada procedente del mundo exterior y, de este modo, protegiendo el objeto real.

A diferencia de la herencia múltiple, los adaptadores se pueden añadir en cualquier momento a cualquier objeto (pero no se pueden eliminar), lo que permite una mayor flexibilidad a la hora de exportar clases existentes. Otra ventaja de los adaptadores es que proporcionan una funcionalidad similar, aunque no idéntica, en métodos del mismo nombre en diferentes interfaces, un caso que puede ser bastante habitual al añadir una nueva versión de una interfaz estándar a un objeto.

Para utilizar un adaptador, hay que crear una clase que herede de ` QDBusAbstractAdaptor`. Dado que se trata de una clase estándar derivada de ` QObject`, la macro ` Q_OBJECT ` debe aparecer en la declaración y el archivo fuente debe procesarse con la herramienta `moc`. La clase también debe contener una entrada ` Q_CLASSINFO ` con el nombre ` "D-Bus Interface" `, que declare qué interfaz está exportando. Solo se admite una entrada por clase.

Se podrá acceder a cualquier ranura pública de la clase a través del bus mediante mensajes del tipo `MethodCall`. (Consulta «Declaración de ranuras en adaptadores de D-Bus» para obtener más información). Las señales de la clase se retransmitirán automáticamente a través de D-Bus. Sin embargo, no todos los tipos están permitidos en las listas de parámetros de señales o ranuras: consulta «El sistema de tipos de Qt D-Bus » para obtener más información.

Además, cualquier propiedad declarada con ` Q_PROPERTY ` se expondrá automáticamente a través de la interfaz `Properties` en D-Bus. Dado que el sistema de propiedades de ` QObject ` no permite propiedades no legibles, no es posible declarar propiedades de solo escritura mediante adaptadores.

Más información:

Véase también « QDBusAbstractAdaptor ».

© 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.