QDBusContext Class

class MyObject: public QObject,
                protected QDBusContext
{
    Q_OBJECT

    QDBusConnection conn;
    QDBusMessage msg;

    //...

protected slots:
    void process();
public slots:
    void methodWithError();
    QString methodWithDelayedReply();
};

void MyObject::methodWithError()
{
    sendErrorReply(QDBusError::NotSupported,
                   "The method call 'methodWithError()' is not supported");
}

QString MyObject::methodWithDelayedReply()
{
    conn = connection();
    msg = message();
    setDelayedReply(true);
    QMetaObject::invokeMethod(this, &MyObject::process, Qt::QueuedConnection);
    return QString();
}

メンバ関数の説明

QDBusContext::QDBusContext()

空の QDBusContext を構築します。

[noexcept] QDBusContext::~QDBusContext()

空のデストラクタ。

bool QDBusContext::calledFromDBus() const

D-Bus 呼び出しを処理している場合はtrue を返します。この関数がtrue を返した場合、このクラスの残りの関数を使用できます。

この関数がfalse を返したときにこれらの関数にアクセスすることは未定義であり、クラッシュにつながる可能性があります。

QDBusConnection QDBusContext::connection() const

この呼び出しが受信された接続を返します。

bool QDBusContext::isDelayedReply() const

この呼び出しの応答が遅延する場合は、true を返す。

setDelayedReply()も参照のこと 。

const QDBusMessage &QDBusContext::message() const

このコールを生成したメッセージを返す。

void QDBusContext::sendErrorReply(const QString &name, const QString &msg = QString()) const

呼び出し元への応答として、エラーname 。オプションのmsg パラメータは、失敗を説明する人間が読めるテキストである。

エラーが送信された場合、呼び出されたスロットからの戻り値と出力パラメータはQt D-Busによって無視されます。

void QDBusContext::sendErrorReply(QDBusError::ErrorType type, const QString &msg = QString()) const

これはオーバーロードされた関数です。

呼び出し元への返信としてエラーtype を送信します。オプションのmsg パラメータは、失敗を説明する人間が読めるテキストです。

エラーが送信された場合、呼び出されたスロットからの戻り値と出力パラメータは Qt D-Bus によって無視されます。

void QDBusContext::setDelayedReply(bool enable) const

この呼び出しが遅延応答を持つかどうかを設定します。

enable が false の場合、Qt D-Bus は、コールされたスロットが戻るとすぐに、必要であれば、コール元へのリプライを自動的に生成します。

enable が真の場合、Qt D-Bus は自動返信を生成しません。また、スロットからの戻り値や出力パラメータも無視されます。代わりに、呼び出されたオブジェクトは、受信メッセージを保存し、後で返信またはエラーを送信する責任があります。

返信を送信しないと、D-Busによって自動タイムアウト・エラーが生成されます。

isDelayedReply()も参照してください 。