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 가 true인 경우, Qt D-Bus 는 자동 응답을 생성하지 않습니다. 또한 슬롯의 반환 값과 모든 출력 매개변수를 무시합니다. 대신, 호출된 객체가 수신된 메시지를 저장하고 나중에 응답이나 오류를 전송할 책임이 있습니다.

답장을 보내지 못하면 D-Bus에서 자동 타임아웃 오류가 발생합니다.

isDelayedReply()도 참조하십시오 .