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();
}

Dokumentation der Mitgliedsfunktionen

QDBusContext::QDBusContext()

Konstruiert einen leeren QDBusContext.

[noexcept] QDBusContext::~QDBusContext()

Ein leerer Destruktor.

bool QDBusContext::calledFromDBus() const

Gibt true zurück, wenn wir einen D-Bus-Aufruf verarbeiten. Wenn diese Funktion true zurückgibt, sind die übrigen Funktionen dieser Klasse verfügbar.

Der Zugriff auf diese Funktionen, wenn diese Funktion false zurückgibt, ist undefiniert und kann zu Abstürzen führen.

QDBusConnection QDBusContext::connection() const

Gibt die Verbindung zurück, von der dieser Anruf empfangen wurde.

bool QDBusContext::isDelayedReply() const

Gibt true zurück, wenn dieser Aufruf eine verzögerte Antwort hat.

Siehe auch setDelayedReply().

const QDBusMessage &QDBusContext::message() const

Gibt die Nachricht zurück, die diesen Aufruf ausgelöst hat.

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

Sendet einen Fehler name als Antwort an den Aufrufer. Der optionale Parameter msg ist ein von Menschen lesbarer Text, der den Fehler erklärt.

Wenn ein Fehler gesendet wird, werden der Rückgabewert und alle Ausgabeparameter des aufgerufenen Slots von Qt D-Bus ignoriert.

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

Dies ist eine überladene Funktion.

Sendet einen Fehler type als Antwort an den Aufrufer. Der optionale Parameter msg ist ein von Menschen lesbarer Text, der den Fehler erklärt.

Wenn ein Fehler gesendet wird, werden der Rückgabewert und alle Ausgabeparameter des aufgerufenen Slots von Qt D-Bus ignoriert.

void QDBusContext::setDelayedReply(bool enable) const

Legt fest, ob dieser Aufruf eine verzögerte Antwort haben wird oder nicht.

Wenn enable false ist, wird Qt D-Bus automatisch eine Antwort an den Aufrufer generieren, sobald der aufgerufene Slot zurückkehrt.

Wenn enable wahr ist, erzeugt Qt D-Bus keine automatischen Antworten. Es wird auch den Rückgabewert des Slots und alle Ausgabeparameter ignorieren. Stattdessen ist das aufgerufene Objekt für die Speicherung der eingehenden Nachricht verantwortlich und sendet eine Antwort oder einen Fehler zu einem späteren Zeitpunkt.

Wird keine Antwort gesendet, führt dies zu einem automatischen Timeout-Fehler, der von D-Bus erzeugt wird.

Siehe auch isDelayedReply().