Declaración de ranuras en adaptadores de D-Bus
Las ranuras en los adaptadores de D-Bus se declaran igual que las ranuras públicas normales, pero sus parámetros deben seguir ciertas reglas (consulta «El sistema de tipos de Qt D-Bus » para obtener más información). Las ranuras cuyos parámetros no sigan esas reglas o que no sean públicas no serán accesibles a través de D-Bus.
Las ranuras pueden tener un parámetro de tipo ` const QDBusMessage &`, que debe aparecer al final de la lista de parámetros de entrada, antes de cualquier parámetro de salida. Este parámetro, si está presente, se inicializará con una copia del mensaje actual que se está procesando, lo que permite al destinatario obtener información sobre el remitente, como su nombre de conexión.
Las ranuras pueden ser de tres tipos:
- Asíncronas
- Solo de entrada
- De entrada y salida
Ranuras asíncronas
Las ranuras asíncronas son aquellas que normalmente no devuelven ninguna respuesta a la función que las invoca. Por ese motivo, no pueden aceptar parámetros de salida. En la mayoría de los casos, cuando se ejecuta la primera línea de la ranura, la función que la invoca ya ha reanudado su funcionamiento.
Sin embargo, las ranuras no deben basarse en ese comportamiento. Los problemas de programación y envío de mensajes podrían alterar el orden en que se ejecuta la ranura. El código que pretenda sincronizarse con la función llamante debe proporcionar su propio método de sincronización.
Las ranuras asíncronas se marcan con la palabra clave « Q_NOREPLY » en la firma del método, antes del tipo de retorno « void » y del nombre de la ranura. La ranura « quit() » del ejemplo «D-Bus Complex Ping Pong» es un ejemplo de ello.
Ranuras de solo entrada
Las ranuras de solo entrada son ranuras normales que aceptan parámetros pasados por valor o por referencia a una constante. Sin embargo, a diferencia de las ranuras asíncronas, el llamante suele esperar a que el llamado haya finalizado antes de reanudar la operación. Por lo tanto, las ranuras no asíncronas no deben bloquearse o deben indicar explícitamente en su documentación que pueden hacerlo.
Las ranuras de solo entrada no tienen ninguna marca especial en su firma, salvo que solo aceptan parámetros pasados por valor o por referencia constante. Opcionalmente, las ranuras pueden aceptar un parámetro « QDBusMessage » como último parámetro, que puede utilizarse para realizar un análisis adicional del mensaje de llamada al método.
Ranuras de entrada y salida
Al igual que las ranuras de solo entrada, las ranuras de entrada y salida son aquellas en las que el llamante espera una respuesta. Sin embargo, a diferencia de las de solo entrada, esta respuesta contendrá datos. Las ranuras que emiten datos pueden contener referencias no constantes y también pueden devolver un valor. No obstante, todos los parámetros de salida deben aparecer al final de la lista de argumentos y no pueden intercalarse con argumentos de entrada. Opcionalmente, puede aparecer un argumento ` QDBusMessage ` entre los argumentos de entrada y los de salida.
Respuestas automáticas
Las respuestas de los métodos se generan automáticamente con el contenido de los parámetros de salida (si los hubiera) mediante la implementación de ` Qt D-Bus `. Las ranuras no tienen que preocuparse de crear objetos ` QDBusMessage ` adecuados ni de enviarlos a través de la conexión.
Sin embargo, la posibilidad de hacerlo sigue existiendo. Si el slot detecta que necesita enviar una respuesta especial o incluso un error, puede hacerlo utilizando QDBusMessage::createReply() o QDBusMessage::createErrorReply() sobre el parámetro QDBusMessage y enviarlo con QDBusConnection::send(). La implementación de Qt D-Bus no generará ninguna respuesta si el slot lo hace.
Advertencia: Cuando un llamante realiza una llamada a un método y espera una respuesta, solo esperará durante un tiempo limitado. Los slots que tengan previsto tardar mucho tiempo en completarse deben dejar claro este hecho en la documentación, de modo que los llamantes puedan establecer correctamente tiempos de espera más largos.
Respuestas retrasadas
En algunas circunstancias, es posible que la ranura llamada no pueda procesar la solicitud de forma inmediata. Esto suele ocurrir cuando la solicitud implica una operación de E/S o de red que puede bloquearse.
Si este es el caso, el slot debe devolver el control al bucle principal de la aplicación para evitar que se cuelgue la interfaz de usuario, y reanudar el proceso más tarde. Para lograrlo, debe utilizar el parámetro adicional « QDBusMessage » al final de la lista de parámetros de entrada y solicitar una respuesta diferida.
Para ello, escribimos una ranura que almacena los datos de la solicitud en una estructura persistente, indicando al llamante mediante QDBusMessage::setDelayedReply(true) que la respuesta se enviará más tarde.
struct RequestData
{
QString request;
QString processedData;
QDBusMessage reply;
};
QString processRequest(const QString &request, const QDBusMessage &message)
{
RequestData *data = new RequestData;
data->request = request;
message.setDelayedReply(true);
data->reply = message.createReply();
appendRequest(data);
return QString();
}En este caso, el valor de retorno no tiene importancia; devolvemos un valor arbitrario para satisfacer al compilador.
Cuando se procese la solicitud y haya una respuesta disponible, esta deberá enviarse utilizando el objeto ` QDBusMessage ` que se obtuvo. En nuestro ejemplo, el código de respuesta podría ser algo como lo siguiente:
void sendReply(RequestData *data)
{
// data->processedData has been initialized with the request's reply
QDBusMessage &reply = data->reply;
// send the reply over D-Bus:
reply << data->processedData;
QDBusConnection::sessionBus().send(reply);
// dispose of the transaction data
delete data;
}Como se puede ver en el ejemplo, cuando se utiliza una respuesta diferida, Qt D-Bus ignorará los valores de retorno de la ranura. Estos solo se utilizan para determinar la firma de la ranura al comunicar la descripción del adaptador a aplicaciones remotas, o en caso de que el código de la ranura decida no utilizar una respuesta diferida.
La propia respuesta diferida se solicita a Qt D-Bus llamando a QDBusMessage::reply() sobre el mensaje original. A partir de ahí, es responsabilidad del código llamado enviar finalmente una respuesta al llamante.
Advertencia: Cuando quien realiza la llamada efectúa una llamada a un método y espera una respuesta, solo esperará durante un tiempo limitado. Las ranuras que tengan previsto tardar mucho tiempo en completarse deben dejar claro este hecho en la documentación, de modo que quienes las llamen puedan establecer correctamente tiempos de espera más largos.
Véase también «Uso de adaptadores de Qt D-Bus », «Declaración de señales en adaptadores de D-Bus», «El sistema de tipos de Qt D-Bus », « QDBusConnection » y « QDBusMessage ».
© 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.