QMqttServerConnectionProperties Class
QMqttServerConnectionProperties 클래스는 QMqttClient 가 연결된 서버의 구성 옵션을 나타냅니다. 더 보기...
헤더: | #include <QMqttServerConnectionProperties> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Mqtt) target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
qmake: | QT += mqtt |
상속합니다: | QMqttConnectionProperties |
공용 타입
enum | ServerPropertyDetail { None, SessionExpiryInterval, MaximumReceive, MaximumQoS, RetainAvailable, …, AuthenticationData } |
flags | ServerPropertyDetails |
공용 함수
QMqttServerConnectionProperties::ServerPropertyDetails | availableProperties() const |
bool | clientIdAssigned() const |
bool | isValid() const |
quint8 | maximumQoS() const |
QString | reason() const |
QMqtt::ReasonCode | reasonCode() const |
QString | responseInformation() const |
bool | retainAvailable() const |
quint16 | serverKeepAlive() const |
QString | serverReference() const |
bool | sharedSubscriptionSupported() const |
bool | subscriptionIdentifierSupported() const |
bool | wildcardSupported() const |
상세 설명
연결이 설정되면 서버는 연결 속성에 대한 추가 세부 정보를 보낼 수 있습니다. availableProperties ()를 사용하여 서버가 설정한 속성을 식별합니다. 서버에서 프로퍼티를 설정하지 않은 경우 기본값이 사용되며, 이 인스턴스의 액세스 함수를 호출하여 프로퍼티를 가져올 수 있습니다.
참고: 연결 속성은 MQTT 5.0 사양의 일부이며 더 낮은 프로토콜 수준으로 연결할 때는 사용할 수 없습니다. 자세한 내용은 QMqttClient::ProtocolVersion 을 참조하세요.
멤버 유형 문서
열거형 QMqttServerConnectionProperties::ServerPropertyDetail
플래그 QMqttServerConnectionProperties::ServerPropertyDetails
연결 설정 후 서버 또는 클라이언트가 설정할 수 있는 프로퍼티를 지정하는 열거형입니다.
Constant | 값 | 설명 |
---|---|---|
QMqttServerConnectionProperties::None | 0x00000000 | 프로퍼티가 지정되지 않았습니다. |
QMqttServerConnectionProperties::SessionExpiryInterval | 0x00000001 | 연결이 끊어진 후 서버가 세션을 유지하는 시간(초)입니다. |
QMqttServerConnectionProperties::MaximumReceive | 0x00000002 | 서버가 동시에 관리할 수 있는 최대 QoS 1 및 2 메시지 수입니다. |
QMqttServerConnectionProperties::MaximumQoS | 0x00000004 | 서버가 이해할 수 있는 최대 QoS 수준입니다. |
QMqttServerConnectionProperties::RetainAvailable | 0x00000010 | 보존된 메시지가 지원되는지 여부를 지정합니다. |
QMqttServerConnectionProperties::MaximumPacketSize | 0x00000020 | 메시지 헤더 및 속성을 포함한 최대 패킷 크기를 지정합니다. |
QMqttServerConnectionProperties::AssignedClientId | 0x00000040 | 서버에서 클라이언트 식별자를 할당할지 여부를 지정합니다. |
QMqttServerConnectionProperties::MaximumTopicAlias | 0x00000080 | 최대 토픽 별칭의 양을 지정합니다. |
QMqttServerConnectionProperties::ReasonString | 0x00000100 | 연결 상태에 대한 자세한 내용을 제공하는 문자열을 지정합니다. |
QMqttServerConnectionProperties::UserProperty | 0x00000200 | 추가 사용자 속성을 지정합니다. |
QMqttServerConnectionProperties::WildCardSupported | 0x00000400 | 서버가 와일드카드 구독을 지원하는지 여부를 지정합니다. |
QMqttServerConnectionProperties::SubscriptionIdentifierSupport | 0x00000800 | 서버가 구독 식별자를 지원하는지 여부를 지정합니다. |
QMqttServerConnectionProperties::SharedSubscriptionSupport | 0x00001000 | 서버가 공유 구독을 지원하는지 여부를 지정합니다. |
QMqttServerConnectionProperties::ServerKeepAlive | 0x00002000 | 서버가 클라이언트로부터 연결 유지 패킷을 기대하는 시간(초)을 지정합니다. |
QMqttServerConnectionProperties::ResponseInformation | 0x00004000 | 응답 정보를 지정합니다. |
QMqttServerConnectionProperties::ServerReference | 0x00008000 | 클라이언트가 연결할 대체 서버 주소를 지정합니다. |
QMqttServerConnectionProperties::AuthenticationMethod | 0x00010000 | 인증 방법을 지정합니다. |
QMqttServerConnectionProperties::AuthenticationData | 0x00020000 | 인증 데이터를 지정합니다. |
서버 프로퍼티 디테일 유형은 QFlags<서버 프로퍼티 디테일>에 대한 타입 정의입니다. 서버 프로퍼티 디테일 값의 OR 조합을 저장합니다.
멤버 함수 문서
QMqttServerConnectionProperties::ServerPropertyDetails QMqttServerConnectionProperties::availableProperties() const
서버에서 지정한 사용 가능한 프로퍼티를 반환합니다.
bool QMqttServerConnectionProperties::clientIdAssigned() const
서버가 클라이언트에 새 클라이언트 식별자를 할당하면 true
을 반환합니다.
QMqttClient::clientId()도 참조하세요 .
bool QMqttServerConnectionProperties::isValid() const
서버가 연결 승인의 일부로 속성을 제공한 경우 true
을 반환합니다. 프로퍼티가 제공되지 않은 경우 false
을 반환합니다.
quint8 QMqttServerConnectionProperties::maximumQoS() const
서버가 메시지 게시를 위해 지원하는 최대 QoS 수준을 반환합니다. 서버가 보고한 최대 QoS 수준을 초과하는 QoS 수준으로 메시지를 게시하는 것은 프로토콜 위반입니다.
클라이언트가 QoS 1 또는 QoS 2를 지원할 필요가 없는 경우에는 구독의 최대 QoS 수준을 지원할 수 있는 값으로 제한해야 하며, 그러면 서버는 지원되는 최대 및 제한된 QoS 수준으로 메시지를 게시합니다.
기본값은 2
입니다.
QMqttClient::publish() 및 QMqttClient::subscribe()도 참조하세요 .
QString QMqttServerConnectionProperties::reason() const
이 응답과 연관된 이유 문자열을 반환합니다.
QMqtt::ReasonCode QMqttServerConnectionProperties::reasonCode() const
이 응답과 관련된 이유 코드를 반환합니다.
QString QMqttServerConnectionProperties::responseInformation() const
응답 정보를 반환합니다.
bool QMqttServerConnectionProperties::retainAvailable() const
서버가 보존된 메시지를 수락하면 true
을 반환합니다. 기본값은 true
입니다.
quint16 QMqttServerConnectionProperties::serverKeepAlive() const
서버가 킵 얼라이브로 요청한 시간(초)을 반환합니다. 이 값은 클라이언트 측에서 설정된 킵 얼라이브를 덮어씁니다.
QMqttClient::setKeepAlive()도 참조하세요 .
QString QMqttServerConnectionProperties::serverReference() const
클라이언트가 연결할 때 대신 사용할 수 있는 서버 주소를 반환합니다. 일반적으로 0x9c
(다른 서버 사용) 또는 0x9c
(서버 이동)이라는 이유 코드와 함께 사용됩니다.
bool QMqttServerConnectionProperties::sharedSubscriptionSupported() const
서버가 공유 구독을 허용하는 경우 true
을 반환합니다. 기본값은 true
입니다.
bool QMqttServerConnectionProperties::subscriptionIdentifierSupported() const
서버가 구독 식별자를 수락하면 true
을 반환합니다. 새 구독을 만들 때 구독 식별자를 서버에 전달할 수 있습니다.
기본값은 true
입니다.
QMqttSubscriptionProperties::setSubscriptionIdentifier()도 참조하세요 .
bool QMqttServerConnectionProperties::wildcardSupported() const
서버가 와일드카드를 포함한 구독을 수락하는 경우 true
을 반환합니다. 기본값은 true
입니다.
© 2025 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.