QDBusServiceWatcher Class
La clase QDBusServiceWatcher permite al usuario supervisar los cambios en un servicio de bus. Más información...
| Encabezado: | #include <QDBusServiceWatcher> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DBus) target_link_libraries(mytarget PRIVATE Qt6::DBus) |
| qmake: | QT += dbus |
| Heredan: | QObject |
Tipos públicos
| flags | WatchMode |
| enum | WatchModeFlag { WatchForRegistration, WatchForUnregistration, WatchForOwnerChange } |
Propiedades
- watchMode : WatchMode
- watchedServices : QStringList
Funciones públicas
| QDBusServiceWatcher(QObject *parent = nullptr) | |
| QDBusServiceWatcher(const QString &service, const QDBusConnection &connection, QDBusServiceWatcher::WatchMode watchMode = WatchForOwnerChange, QObject *parent = nullptr) | |
| virtual | ~QDBusServiceWatcher() |
| void | addWatchedService(const QString &newService) |
| QBindable<QDBusServiceWatcher::WatchMode> | bindableWatchMode() |
| QBindable<QStringList> | bindableWatchedServices() |
| QDBusConnection | connection() const |
| bool | removeWatchedService(const QString &service) |
| void | setConnection(const QDBusConnection &connection) |
| void | setWatchMode(QDBusServiceWatcher::WatchMode mode) |
| void | setWatchedServices(const QStringList &services) |
| QDBusServiceWatcher::WatchMode | watchMode() const |
| QStringList | watchedServices() const |
Señales
| void | serviceOwnerChanged(const QString &serviceName, const QString &oldOwner, const QString &newOwner) |
| void | serviceRegistered(const QString &serviceName) |
| void | serviceUnregistered(const QString &serviceName) |
Descripción detallada
Un objeto QDBusServiceWatcher puede utilizarse para notificar a la aplicación un cambio de titularidad de un nombre de servicio en el bus. Dispone de tres modos de vigilancia:
- Vigilancia exclusiva del registro de servicios.
- Vigilancia solo de la baja de servicios.
- Vigilancia de cualquier tipo de cambio de titularidad del servicio (modo predeterminado).
Además de crearse o eliminarse, los servicios pueden cambiar de propietario sin que se produzca una operación de baja o alta. Por lo tanto, es posible que las señales ` serviceRegistered()` y ` serviceUnregistered()` no se emitan si esto ocurre.
Esta clase es más eficiente que utilizar la señal QDBusConnectionInterface::serviceOwnerChanged(), ya que permite recibir únicamente las señales que le interesan a la clase.
Si el nombre de un servicio termina con el carácter «*», se coincidirán todos los nombres de servicio dentro del espacio de nombres especificado.
Por ejemplo, «com.example.backend1*» coincidirá con
- com.example.backend1
- com.example.backend1.foo
- com.example.backend1.foo.bar
No se coincidirán subcadenas dentro del mismo dominio, por ejemplo, «com.example.backend12».
Véase también QDBusConnection.
Documentación sobre tipos de miembros
enum QDBusServiceWatcher::WatchModeFlag
flags QDBusServiceWatcher::WatchMode
QDBusServiceWatcher admite tres modos de vigilancia diferentes, que se configuran mediante este indicador:
| Constante | Valor | Descripción |
|---|---|---|
QDBusServiceWatcher::WatchForRegistration | 0x01 | Vigila únicamente el registro del servicio, ignorando cualquier señal relacionada con cambios de titularidad de otros servicios. |
QDBusServiceWatcher::WatchForUnregistration | 0x02 | Vigila únicamente la cancelación del registro de servicios, ignorando cualquier señal relacionada con cambios de titularidad de otros servicios. |
QDBusServiceWatcher::WatchForOwnerChange | 0x03 | vigilar cualquier tipo de cambio de titularidad del servicio. |
El tipo WatchMode es una definición de tipo (typedef) para QFlags<WatchModeFlag>. Almacena una combinación OR de valores de WatchModeFlag.
Documentación de la propiedad
[bindable] watchMode : WatchMode
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene el modo de vigilancia actual de este objeto « QDBusServiceWatcher ».
El valor por defecto de esta propiedad es QDBusServiceWatcher::WatchForOwnershipChange.
Funciones de acceso:
| QDBusServiceWatcher::WatchMode | watchMode() const |
| void | setWatchMode(QDBusServiceWatcher::WatchMode mode) |
[bindable] watchedServices : QStringList
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene la lista de servicios supervisados.
Nota: Modificar esta lista con setServicesWatched() es una operación costosa. Si es posible, es preferible modificarla mediante addWatchedService() y removeWatchedService().
Funciones de acceso:
| QStringList | watchedServices() const |
| void | setWatchedServices(const QStringList &services) |
Documentación de funciones de miembro
[explicit] QDBusServiceWatcher::QDBusServiceWatcher(QObject *parent = nullptr)
Crea un objeto QDBusServiceWatcher. Ten en cuenta que, hasta que establezcas una conexión mediante setConnection(), este objeto no emitirá ninguna señal.
El parámetro ` parent ` se pasa a ` QObject ` para establecer el padre de este objeto.
QDBusServiceWatcher::QDBusServiceWatcher(const QString &service, const QDBusConnection &connection, QDBusServiceWatcher::WatchMode watchMode = WatchForOwnerChange, QObject *parent = nullptr)
Crea un objeto `QDBusServiceWatcher` y lo vincula a la conexión ` connection `. Además, esta función comienza inmediatamente a supervisar los cambios de ` watchMode ` en el servicio ` service`.
El parámetro parent se pasa a QObject para establecer el padre de este objeto.
[virtual noexcept] QDBusServiceWatcher::~QDBusServiceWatcher()
Destruye el objeto ` QDBusServiceWatcher ` y libera todos los recursos asociados a él.
void QDBusServiceWatcher::addWatchedService(const QString &newService)
Añade newService a la lista de servicios que debe supervisar este objeto. Esta función es más eficiente que setWatchedServices() y debería utilizarse siempre que sea posible para añadir servicios.
Elimina cualquier vinculación existente de watchedServices.
QDBusConnection QDBusServiceWatcher::connection() const
Devuelve el objeto « QDBusConnection » al que está vinculado este objeto.
Véase también setConnection().
bool QDBusServiceWatcher::removeWatchedService(const QString &service)
Elimina service de la lista de servicios supervisados por este objeto. Ten en cuenta que las notificaciones de D-Bus son asíncronas, por lo que es posible que aún haya señales pendientes de entrega relacionadas con service. Dichas señales se seguirán emitiendo cada vez que se procesen los mensajes de D-Bus.
Elimina cualquier enlace existente de watchedServices.
Esta función devuelve true si se ha eliminado algún servicio.
[signal] void QDBusServiceWatcher::serviceOwnerChanged(const QString &serviceName, const QString &oldOwner, const QString &newOwner)
Esta señal se emite cada vez que este objeto detecta que se ha producido un cambio de titularidad del servicio serviceName. El parámetro oldOwner contiene el nombre del antiguo titular y newOwner es el nuevo titular. Tanto oldOwner como newOwner son nombres de conexión únicos.
Ten en cuenta que esta señal también se emite cada vez que el servicio serviceName se registra o se da de baja. Si se ha registrado, oldOwner contendrá una cadena vacía, mientras que si se ha dado de baja, newOwner contendrá una cadena vacía.
Si solo necesitas saber si el servicio está registrado o dado de baja, sin que se te notifique que ha cambiado la titularidad, plantéate utilizar los modos específicos para esas operaciones. Esta clase es más eficiente si utilizas los modos más específicos.
Véase también serviceRegistered() y serviceUnregistered().
[signal] void QDBusServiceWatcher::serviceRegistered(const QString &serviceName)
Esta señal se emite cada vez que este objeto detecta que el servicio serviceName está disponible en el bus.
Véanse también serviceUnregistered() y serviceOwnerChanged().
[signal] void QDBusServiceWatcher::serviceUnregistered(const QString &serviceName)
Esta señal se emite cada vez que este objeto detecta que el servicio serviceName ha sido dado de baja del bus y ya no está disponible.
Véase también serviceRegistered() y serviceOwnerChanged().
void QDBusServiceWatcher::setConnection(const QDBusConnection &connection)
Establece la conexión D-Bus a la que está vinculado este objeto como connection. Todos los servicios supervisados se transferirán a esta conexión.
Ten en cuenta que los objetos ` QDBusConnection ` se cuentan por referencias: ` QDBusServiceWatcher ` mantendrá una referencia a esta conexión mientras exista. La conexión no se cierra hasta que el recuento de referencias llegue a cero, lo que garantiza que se reciban todas las notificaciones mientras exista este objeto ` QDBusServiceWatcher `.
Véase también connection().
void QDBusServiceWatcher::setWatchedServices(const QStringList &services)
Establece la lista de servicios D-Bus supervisados en services.
Ten en cuenta que establecer la lista completa implica eliminar todas las reglas anteriores de vigilancia de servicios y añadir otras nuevas. Se trata de una operación costosa que debe evitarse, si es posible. En su lugar, utiliza addWatchedService() y removeWatchedService() siempre que puedas para manipular las entradas de la lista.
Elimina cualquier enlace existente de « watchedServices ».
Nota: Funciónde asignación para la propiedad watchedServices.
Véase también watchedServices().
QStringList QDBusServiceWatcher::watchedServices() const
Devuelve la lista de servicios D-Bus que se están supervisando.
Nota: Funcióngetter para la propiedad watchedServices.
Véase también setWatchedServices().
© 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.