QDBusConnection Class

멤버 함수 문서

[explicit] QDBusConnection::QDBusConnection(const QString &name)

name 라는 이름의 연결에 연결된 QDBusConnection 객체를 생성합니다.

이 메서드는 연결을 열지 않습니다. 연결을 열려면 connectToBus()을 호출해야 합니다.

QDBusConnection::QDBusConnection(const QDBusConnection &other)

other 연결의 복사본을 생성합니다.

[noexcept] QDBusConnection::~QDBusConnection()

이 객체를 해제합니다. 이 작업만으로는 연결이 닫히지 않으므로, 연결을 닫으려면 ` disconnectFromBus()`을 호출해야 합니다.

QDBusPendingCall QDBusConnection::asyncCall(const QDBusMessage &message, int timeout = -1) const

이 연결을 통해 message 를 전송하고 즉시 반환합니다. 이 함수는 메서드 호출에만 적합합니다. 이 함수는 응답 상태를 추적하는 데 사용할 수 있는 QDBusPendingCall 유형의 객체를 반환합니다.

timeout 밀리초 이내에 응답을 받지 못하면, 호출이 만료되었음을 나타내는 자동 오류가 전달됩니다. 기본 timeout 값은 -1이며, 이는 프로세스 간 통신에 적합한 구현 정의 값(일반적으로 25초)으로 대체됩니다. 이 타임아웃은 QDBusPendingCall::waitForFinished()에서 대기할 수 있는 최대 시간 제한이기도 합니다.

호출을 더 편리하게 수행하는 방법은 QDBusInterface::asyncCall() 함수를 참조하십시오.

QString QDBusConnection::baseService() const

이 ` QDBusConnection ` 객체가 연결된 상태라면 해당 연결에 대한 고유한 연결 이름을 반환하고, 그렇지 않은 경우 빈 ` QString `을 반환합니다.

고유 연결 이름은 ":x.xxx" 형식(여기서 x는 10진수 자릿수)의 문자열로, 연결 시 D-Bus 서버 데몬에 의해 할당됩니다. 이는 버스에서 이 클라이언트를 고유하게 식별합니다.

이 함수는 피어 투 피어(peer-to-peer) 연결의 경우 빈 ` QString `을 반환합니다.

QDBusMessage QDBusConnection::call(const QDBusMessage &message, QDBus::CallMode mode = QDBus::Block, int timeout = -1) const

이 연결을 통해 ` message `을 전송하고, 응답을 기다리며 최대 ` timeout ` 밀리초 동안 대기합니다. 이 함수는 메서드 호출에만 적합합니다. 이 함수는 응답 메시지를 반환 값으로 제공하며, 반환 값의 타입은 ` QDBusMessage::ReplyMessage ` 또는 ` QDBusMessage::ErrorMessage` 중 하나입니다.

timeout 밀리초 이내에 응답을 받지 못하면 호출이 만료되었음을 나타내는 자동 오류가 전달됩니다. 기본값인 timeout 은 -1이며, 이는 프로세스 간 통신에 적합한 구현 정의 값(일반적으로 25초)으로 대체됩니다.

호출을 더 편리하게 수행하는 방법은 QDBusInterface::call() 함수를 참조하십시오.

bool QDBusConnection::callWithCallback(const QDBusMessage &message, QObject *receiver, const char *returnMethod, const char *errorMethod, int timeout = -1) const

이 연결을 통해 message 을 전송하고 즉시 반환합니다. 응답을 수신하면 receiver 객체에서 returnMethod 메서드가 호출됩니다. 오류가 발생하면 대신 errorMethod 메서드가 호출됩니다.

timeout 밀리초 이내에 응답을 받지 못하면, 호출이 만료되었음을 나타내는 자동 오류가 전달됩니다. 기본 timeout 는 -1이며, 이는 프로세스 간 통신에 적합한 구현 정의 값(일반적으로 25초)으로 대체됩니다.

이 함수는 메서드 호출에만 적합합니다. 매개변수 유형이 일치하고 오류가 발생하지 않는 한, 슬롯이 응답과 함께 정확히 한 번 호출될 것이 보장됩니다.

메시지가 전송된 경우 ` true `를 반환하고, 메시지를 전송할 수 없는 경우 `false`를 반환합니다.

bool QDBusConnection::connect(const QString &service, const QString &path, const QString &interface, const QString &name, QObject *receiver, const char *slot)

service, path, interface 및 name 매개변수로 지정된 신호를 객체 receiver 의 슬롯 slot 에 연결합니다. 인자 service 및 path 는 비워둘 수 있으며, 이는 임의의 원격 애플리케이션에서 (interface, name) 쌍의 임의의 신호로 연결됨을 의미합니다.

연결에 성공하면 ` true `을 반환합니다.

bool QDBusConnection::connect(const QString &service, const QString &path, const QString &interface, const QString &name, const QString &signature, QObject *receiver, const char *slot)

신호를 객체 ` receiver`의 슬롯 ` slot `에 연결합니다. 이전의 `connect()` 오버로딩과 달리, 이 함수는 ` signature ` 변수를 사용하여 연결할 매개변수 시그니처를 지정할 수 있게 해줍니다. 그런 다음 이 함수는 해당 시그니처가 ` slot `로 지정된 슬롯에 전달될 수 있는지 확인하고, 그렇지 않은 경우 `false`를 반환합니다.

연결에 성공하면 ` true `를 반환합니다.

bool QDBusConnection::connect(const QString &service, const QString &path, const QString &interface, const QString &name, const QStringList &argumentMatch, const QString &signature, QObject *receiver, const char *slot)

신호를 객체 ` receiver`의 슬롯 ` slot `에 연결합니다. 앞서 설명한 `connect()` 오버로드와 달리, 이 함수는 ` signature ` 변수를 사용하여 연결할 매개변수 시그니처를 지정할 수 있게 해줍니다. 그러면 이 함수는 해당 시그니처가 ` slot `로 지정된 슬롯에 전달될 수 있는지 확인하고, 그렇지 않은 경우 `false`를 반환합니다.

argumentMatch 매개변수는 일치시킬 문자열 매개변수를 순차적인 순서대로 나열합니다. 빈 문자열과 일치시키려면, 비어 있지만 null이 아닌 QString (예: QString(""))를 전달해야 한다는 점에 유의하십시오. null인 QString 은 해당 위치에서의 일치를 건너뜁니다.

연결에 성공하면 ` true `를 반환합니다.

[static] QDBusConnection QDBusConnection::connectToBus(QDBusConnection::BusType type, const QString &name)

알려진 버스 중 하나에 대해 ` type ` 유형의 연결을 열고, 해당 연결에 ` name`이라는 연결 이름을 할당합니다. 해당 연결과 연관된 ` QDBusConnection ` 객체를 반환합니다.

[static] QDBusConnection QDBusConnection::connectToBus(const QString &address, const QString &name)

address 주소의 전용 버스(private bus)에 대한 연결을 열고, 이 연결에 ‘ name ’라는 연결 이름을 할당합니다. 해당 연결과 연관된 QDBusConnection 객체를 반환합니다.

[static] QDBusConnection QDBusConnection::connectToPeer(const QString &address, const QString &name)

address 주소에서 피어 투 피어 연결을 열고, 이 연결에 name 라는 연결 이름을 할당합니다. 해당 연결과 연결된 QDBusConnection 객체를 반환합니다.

QDBusConnection::ConnectionCapabilities QDBusConnection::connectionCapabilities() const

버스 서버 또는 피어와 협상된 이 연결의 기능을 반환합니다. 이 ` QDBusConnection `가 연결되어 있지 않은 경우, 이 함수는 기능을 반환하지 않습니다.

bool QDBusConnection::disconnect(const QString &service, const QString &path, const QString &interface, const QString &name, QObject *receiver, const char *slot)

service, path, interface 및 name 매개변수로 지정된 신호를 객체 receiver 의 슬롯 slot 에서 분리합니다. 인수는 connect() 함수에 전달된 것과 동일해야 합니다.

연결 해제가 성공하면 ` true `를 반환합니다.

bool QDBusConnection::disconnect(const QString &service, const QString &path, const QString &interface, const QString &name, const QString &signature, QObject *receiver, const char *slot)

receiver 객체의 slot 슬롯에서 service, path, interface, name 및 signature 매개변수로 지정된 신호의 연결을 끊습니다. 인수는 connect() 함수에 전달된 것과 동일해야 합니다.

연결 해제가 성공하면 true 를 반환합니다.

bool QDBusConnection::disconnect(const QString &service, const QString &path, const QString &interface, const QString &name, const QStringList &argumentMatch, const QString &signature, QObject *receiver, const char *slot)

receiver 객체의 slot 슬롯에서 service, path, interface, name, argumentMatch 및 signature 매개변수로 지정된 신호의 연결을 끊습니다. 인수는 connect() 함수에 전달된 것과 동일해야 합니다.

연결 해제가 성공하면 ` true `를 반환합니다.

[static] void QDBusConnection::disconnectFromBus(const QString &name)

name 라는 이름의 버스 연결을 닫습니다.

동일한 연결에 여전히 QDBusConnection 객체가 연결되어 있는 경우, 모든 참조가 해제될 때까지 연결이 닫히지 않는다는 점에 유의하십시오. 단, QDBusConnection 생성자를 사용하여 더 이상 참조를 생성할 수는 없습니다.

[static] void QDBusConnection::disconnectFromPeer(const QString &name)

name 라는 이름의 피어 연결을 닫습니다.

동일한 연결과 연관된 QDBusConnection 객체가 여전히 존재하는 경우, 모든 참조가 해제될 때까지 연결이 닫히지 않는다는 점에 유의하십시오. 그러나 QDBusConnection 생성자를 사용하여 더 이상 참조를 생성할 수는 없습니다.

QDBusConnectionInterface *QDBusConnection::interface() const

이 연결의 D-Bus 서버 인터페이스를 나타내는 ` QDBusConnectionInterface ` 객체를 반환합니다.

bool QDBusConnection::isConnected() const

이 QDBusConnection 객체가 연결되어 있으면 ` true `를 반환합니다.

QDBusError QDBusConnection::lastError() const

이 연결에서 발생한 마지막 오류를 반환합니다.

이 함수는 저수준 코드용으로 제공됩니다. QDBusInterface::call()를 사용하는 경우, 오류 코드는 반환값을 통해 보고됩니다.

QDBusInterface 및 QDBusMessage도 참조하십시오 .

[static] QByteArray QDBusConnection::localMachineId()

D-Bus 시스템에 등록된 로컬 머신 ID를 반환합니다. D-Bus를 실행하는 각 노드 또는 호스트에는 고유 식별자가 있으며, 파일 시스템과 같은 리소스를 공유할 때 다른 호스트와 구별하는 데 사용할 수 있습니다.

로컬 머신 ID는 시스템 재부팅 후에도 유지된다는 보장이 없으므로, 이 식별자는 파일 시스템과 같은 영구 저장소에 저장해서는 안 됩니다. 이 ID는 현재 부팅 세션이 지속되는 동안에만 일정한 값을 유지한다는 것이 보장됩니다.

QString QDBusConnection::name() const

connectToBus() 함수의 name 매개변수로 지정된, 이 연결의 연결 이름을 반환합니다.

연결 이름은 버스에 대한 실제 기본 연결을 고유하게 식별하는 데 사용할 수 있습니다. 단일 연결에서 생성된 복사본은 항상 암묵적으로 기본 연결을 공유하므로, 동일한 연결 이름을 갖게 됩니다.

반대로, 서로 다른 연결 이름을 가진 두 연결은 항상 서로 다른 버스에 연결되어 있거나, 해당 버스에서 baseService() 함수가 반환하는 고유한 이름이 서로 다를 것입니다.

connectToBus() 및 disconnectFromBus()도 참조하십시오 .

QObject *QDBusConnection::objectRegisteredAt(const QString &path) const

path 에서 지정한 객체 경로에 따라 registerObject()에 등록된 객체를 반환합니다.

bool QDBusConnection::registerObject(const QString &path, QObject *object, QDBusConnection::RegisterOptions options = ExportAdaptors)

object 객체를 path 경로에 등록하고, 등록이 성공하면 true 를 반환합니다. options 매개변수는 object 객체 중 어느 정도를 D-Bus를 통해 노출할지 지정합니다.

이 함수는 기존 객체를 대체하지 않습니다. 경로 path 에 이미 등록된 객체가 있는 경우, 이 함수는 false를 반환합니다. 먼저 unregisterObject()를 사용하여 등록을 해제하십시오.

ExportChildObjects 플래그는 등록된 객체의 경로와 자식 객체의 QObject::objectName 을 기반으로 D-Bus에 자식 객체를 노출합니다. 따라서 자식 객체에 객체 이름이 지정되어 있어야 합니다.

ExportChildObjects 로 등록된 객체의 자식 객체로 다른 객체를 등록할 수는 없습니다.

bool QDBusConnection::registerObject(const QString &path, const QString &interface, QObject *object, QDBusConnection::RegisterOptions options = ExportAdaptors)

object 객체를 path 경로에 interface 인터페이스 이름으로 등록하고, 등록에 성공하면 true 를 반환합니다. options 매개변수는 object 객체의 어느 부분을 D-Bus를 통해 노출할지 지정합니다.

이 함수는 기존 객체를 대체하지 않습니다. 경로 path 에 이미 등록된 객체가 있는 경우, 이 함수는 false를 반환합니다. 먼저 unregisterObject()를 사용하여 등록을 해제하십시오.

ExportChildObjects 플래그는 등록된 객체의 경로와 자식 객체의 QObject::objectName 을 기반으로 D-Bus에 자식 객체를 노출합니다. 따라서 자식 객체에는 객체 이름이 반드시 있어야 합니다.

ExportChildObjects 로 등록된 객체의 자식 객체로 다른 객체를 등록할 수는 없습니다.

bool QDBusConnection::registerService(const QString &serviceName)

serviceName 를 D-Bus 서버에 등록하려고 시도하며, 등록에 성공하면 true 를 반환합니다. 해당 이름이 다른 애플리케이션에 의해 이미 등록되어 있는 경우 등록은 실패합니다.

unregisterService() 및 QDBusConnectionInterface::registerService()도 참조하십시오 .

bool QDBusConnection::send(const QDBusMessage &message) const

응답을 기다리지 않고 이 연결을 통해 ` message `를 전송합니다. 이는 오류, 신호, 반환값은 물론 반환값이 필요하지 않은 호출에 적합합니다.

메시지가 큐에 성공적으로 등록되면 ` true `를 반환하고, 그렇지 않으면 `false`를 반환합니다.

[static] QDBusConnection QDBusConnection::sessionBus()

세션 버스를 통해 열린 ` QDBusConnection ` 객체를 반환합니다. 이 함수가 반환하는 객체 참조는 애플리케이션이 종료될 때까지 유효하며, 애플리케이션이 종료되면 연결이 닫히고 객체가 삭제됩니다.

[noexcept] void QDBusConnection::swap(QDBusConnection &other)

이 연결을 other 로 교체합니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

[static] QDBusConnection QDBusConnection::systemBus()

시스템 버스를 통해 열린 ` QDBusConnection ` 객체를 반환합니다. 이 함수가 반환하는 객체 참조는 ` QCoreApplication`의 소멸자가 실행될 때까지 유효하며, 이때 연결이 닫히고 객체가 삭제됩니다.

void QDBusConnection::unregisterObject(const QString &path, QDBusConnection::UnregisterMode mode = UnregisterNode)

path 로 지정된 객체 경로에서 registerObject()을 통해 등록된 객체의 등록을 해제하며, mode 가 QDBusConnection::UnregisterTree 인 경우 해당 객체의 모든 하위 객체에 대해서도 등록을 해제합니다.

registerObject()를 통해 등록되지 않은 객체는 등록을 해제할 수 없다는 점에 유의하십시오.

bool QDBusConnection::unregisterService(const QString &serviceName)

이전에 registerService()을 통해 등록된 서비스 serviceName 의 등록을 해제하며, 성공하면 true 를 반환합니다.

registerService() 및 QDBusConnectionInterface::unregisterService()도 참조하십시오 .

QDBusConnection &QDBusConnection::operator=(const QDBusConnection &other)

이 객체에 other 연결의 복사본을 생성합니다. 복사 전에 이 객체가 참조하던 연결이 자동으로 끊어지지 않는다는 점에 유의하십시오.

disconnectFromBus()도 참조하십시오 .