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 `을 참조하십시오.
멤버 유형 문서
enum QMqttServerConnectionProperties::ServerPropertyDetail
flags QMqttServerConnectionProperties::ServerPropertyDetails
이 열거형 유형은 연결이 설정된 후 서버 또는 클라이언트가 설정할 수 있는 속성을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
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 | 인증 데이터를 지정합니다. |
ServerPropertyDetails 유형은 QFlags<ServerPropertyDetail>에 대한 typedef입니다. 이 유형은 ServerPropertyDetail 값들의 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 수준과 제한된 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
서버가 요청한 키프 얼라이브(keep alive) 시간을 초 단위로 반환합니다. 이 설정은 클라이언트 측에서 설정된 키프 얼라이브 값을 덮어씁니다.
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`입니다.
© 2026 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.
