QtCoap Namespace
Qt CoAP 모듈 전체에서 사용되는 기타 식별자를 포함합니다. 더 보기...
| 헤더: | #include <QtCoap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Coap)target_link_libraries(mytarget PRIVATE Qt6::Coap) |
| qmake: | QT += coap |
유형
| enum class | Error { Ok, HostNotFound, AddressInUse, TimeOut, BadRequest, …, Unknown } |
| enum class | Method { Invalid, Get, Post, Put, Delete, Other } |
| enum class | MulticastGroup { AllCoapNodesIPv4, AllCoapNodesIPv6LinkLocal, AllCoapNodesIPv6SiteLocal } |
| enum | Port { DefaultPort, DefaultSecurePort } |
| enum class | ResponseCode { EmptyMessage, Created, Deleted, Valid, Changed, …, InvalidCode } |
| enum class | SecurityMode { NoSecurity, PreSharedKey, RawPublicKey, Certificate } |
유형 문서
enum class QtCoap::Error
요청을 처리하는 동안 발견된 오류 상태를 나타냅니다.
| 상수 | 값 | 설명 |
|---|---|---|
QtCoap::Error::Ok | 0 | 오류 조건이 없습니다. |
QtCoap::Error::HostNotFound | 1 | 원격 호스트 이름을 찾을 수 없습니다. |
QtCoap::Error::AddressInUse | 2 | 주소가 이미 사용 중입니다. |
QtCoap::Error::TimeOut | 3 | 응답이 제시간에 도착하지 않았습니다. |
QtCoap::Error::BadRequest | 4 | 요청이 인식되지 않았습니다. |
QtCoap::Error::Unauthorized | 5 | 클라이언트에 요청된 작업을 수행할 권한이 없습니다. |
QtCoap::Error::BadOption | 6 | 하나 이상의 인식할 수 없거나 잘못된 옵션으로 인해 서버에서 요청을 이해할 수 없습니다. |
QtCoap::Error::Forbidden | 7 | 이 리소스에 대한 액세스는 금지되어 있습니다. |
QtCoap::Error::NotFound | 8 | 요청한 리소스를 찾을 수 없습니다. |
QtCoap::Error::MethodNotAllowed | 9 | 서버가 요청된 URL에 사용된 방법을 허용하지 않습니다. |
QtCoap::Error::NotAcceptable | 10 | 요청의 허용 기준을 충족하는 리소스를 찾을 수 없습니다. |
QtCoap::Error::RequestEntityIncomplete | 11 | 서버가 계속 진행하기 위해 필요한 요청 본문의 블록을 받지 못했습니다. 클라이언트가 모든 블록을 보내지 않았거나 서버가 요구하는 순서대로 보내지 않았거나 너무 오래 전에 보내서 서버가 이미 폐기했습니다. |
QtCoap::Error::PreconditionFailed | 12 | 요청 헤더 필드에 지정된 하나 이상의 조건이 서버에서 테스트할 때 거짓으로 평가되었습니다. |
QtCoap::Error::RequestEntityTooLarge | 13 | 요청 페이로드가 서버가 처리할 의향이 있거나 처리할 수 있는 것보다 큽니다. |
QtCoap::Error::UnsupportedContentFormat | 14 | 페이로드가 대상 리소스에서 이 메서드에서 지원되지 않는 형식입니다. |
QtCoap::Error::InternalServerFault | 15 | 서버가 요청을 처리할 수 없는 예기치 않은 조건이 발생했습니다. |
QtCoap::Error::NotImplemented | 16 | 서버가 요청을 처리하는 데 필요한 기능을 지원하지 않습니다. |
QtCoap::Error::BadGateway | 17 | 업스트림 서버에서 오류가 발생했습니다. |
QtCoap::Error::ServiceUnavailable | 18 | 현재 서비스를 사용할 수 없습니다. |
QtCoap::Error::GatewayTimeout | 19 | 서버가 게이트웨이 또는 프록시 역할을 하는 동안 요청을 완료하기 위해 액세스해야 하는 업스트림 서버로부터 적시에 응답을 받지 못했습니다. |
QtCoap::Error::ProxyingNotSupported | 20 | 서버가 Proxy-Uri 옵션에 지정된 URI에 대한 정방향 프록시 역할을 할 수 없거나 원하지 않거나 Proxy-Scheme에 지정된 스키마를 사용합니다. |
QtCoap::Error::Unknown | 21 | 알 수 없는 오류가 발생했습니다. |
enum class QtCoap::Method
이 열거형은 CoAP 요청 메서드를 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
QtCoap::Method::Invalid | 0 | 빈 요청에 대한 기본 요청 메서드입니다. |
QtCoap::Method::Get | 1 | GET 메서드. |
QtCoap::Method::Post | 2 | POST 메서드. |
QtCoap::Method::Put | 3 | PUT 메서드. |
QtCoap::Method::Delete | 4 | DELETE 메서드. |
QtCoap::Method::Other | 5 | 기타 요청 메서드. |
enum class QtCoap::MulticastGroup
이 열거형은 RFC 7252에 정의된 CoAP 멀티캐스트 그룹 주소를 나타냅니다.
| Constant | 값 | 설명 |
|---|---|---|
QtCoap::MulticastGroup::AllCoapNodesIPv4 | 0 | "IPv4 멀티캐스트 주소 공간 레지스트리"의 IPv4 "모든 CoAP 노드" 주소 224.0.1.187. |
QtCoap::MulticastGroup::AllCoapNodesIPv6LinkLocal | 1 | "IPv6 멀티캐스트 주소 공간 레지스트리"의 IPv6 "모든 CoAP 노드" 링크-로컬 범위 주소 FF02::FD. |
QtCoap::MulticastGroup::AllCoapNodesIPv6SiteLocal | 2 | "IPv6 멀티캐스트 주소 공간 레지스트리"의 IPv6 "모든 CoAP 노드" 사이트-로컬 범위 주소 FF05::FD. |
enum QtCoap::Port
이 열거형은 기본 CoAP 포트 값을 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
QtCoap::DefaultPort | 5683 | 비보안 전송에 사용되는 기본 포트입니다. |
QtCoap::DefaultSecurePort | 5684 | 보안 전송에 사용되는 기본 포트입니다. |
enum class QtCoap::ResponseCode
이 열거형은 RFC 7252 및 RFC 7959에 정의된 대로 CoAP 프로토콜의 응답 코드를 나타냅니다.
| Constant | 값 | 설명 |
|---|---|---|
QtCoap::ResponseCode::EmptyMessage | 0x00 | 빈 메시지에 대한 응답 코드입니다. |
QtCoap::ResponseCode::Created | 0x41 | 요청이 성공하여 새 리소스가 생성되었습니다. 이 응답 코드는 HTTP 201 "생성됨"에 해당합니다. |
QtCoap::ResponseCode::Deleted | 0x42 | 리소스가 성공적으로 삭제되었습니다. 이 응답 코드는 HTTP 204 "콘텐츠 없음"에 해당하지만 DELETE 및 특정 상황에서는 POST와 같이 리소스를 더 이상 사용할 수 없게 만드는 요청에 대한 응답으로만 사용됩니다. |
QtCoap::ResponseCode::Valid | 0x43 | 이 응답 코드는 HTTP 304 "수정되지 않음"과 관련이 있지만 ETag 옵션에 지정된 엔티티 태그로 식별된 응답이 유효하다는 것을 나타내는 데만 사용됩니다. |
QtCoap::ResponseCode::Changed | 0x44 | 리소스가 성공적으로 수정되었습니다. 이 응답 코드는 HTTP 204 "콘텐츠 없음"에 해당하지만 POST 및 PUT 요청에 대한 응답에만 사용됩니다. |
QtCoap::ResponseCode::Content | 0x45 | 요청이 성공했습니다. 이 응답 코드는 HTTP 200 "OK"에 해당하지만 GET 요청에 대한 응답에만 사용됩니다. |
QtCoap::ResponseCode::Continue | 0x5F | 현재 블록의 전송이 성공했으며 서버가 더 많은 블록을 전송할 것임을 나타냅니다. |
QtCoap::ResponseCode::BadRequest | 0x-80 | 요청이 인식되지 않았습니다. 이 응답 코드는 HTTP 400 "잘못된 요청"에 해당합니다. |
QtCoap::ResponseCode::Unauthorized | 0x-7f | 클라이언트에 요청된 작업을 수행할 권한이 없습니다. 이 응답 코드는 HTTP 401 "권한 없음"에 해당합니다. |
QtCoap::ResponseCode::BadOption | 0x-7e | 인식할 수 없는 옵션으로 인해 서버가 요청을 이해할 수 없습니다. |
QtCoap::ResponseCode::Forbidden | 0x-7d | 이 리소스에 대한 액세스가 금지되었습니다. 이 응답 코드는 HTTP 403 "금지됨"에 해당합니다. |
QtCoap::ResponseCode::NotFound | 0x-7c | 요청한 리소스를 찾을 수 없습니다. 이 응답 코드는 HTTP 404 "찾을 수 없음"에 해당합니다. |
QtCoap::ResponseCode::MethodNotAllowed | 0x-7b | 서버가 요청된 URL에 사용된 방법을 허용하지 않습니다. 이 응답 코드는 HTTP 405 "메서드 허용되지 않음"에 해당하지만 "허용" 헤더 필드와 평행하지 않습니다. |
QtCoap::ResponseCode::NotAcceptable | 0x-7a | 요청의 허용 기준을 충족하는 리소스를 찾을 수 없습니다. 이 응답 코드는 HTTP 406 "허용되지 않음"에 해당하지만 응답 엔티티가 없습니다. |
QtCoap::ResponseCode::RequestEntityIncomplete | 0x-78 | 서버가 요청 본문에서 계속 진행하기 위해 필요한 모든 블록을 수신하지 못했습니다. |
QtCoap::ResponseCode::PreconditionFailed | 0x-74 | 서버에서 테스트할 때 요청 헤더 필드에 주어진 전제 조건이 false 로 평가되었습니다. 이 응답 코드는 HTTP 412 "전제 조건 실패"에 해당합니다. |
QtCoap::ResponseCode::RequestEntityTooLarge | 0x-73 | 요청 페이로드가 서버가 처리할 의향이 있거나 처리할 수 있는 것보다 큽니다. 이 응답 코드는 HTTP 413 "요청 엔티티가 너무 큽니다"에 해당합니다. |
QtCoap::ResponseCode::UnsupportedContentFormat | 0x-72 | 페이로드가 대상 리소스에서 이 메서드에서 지원하지 않는 형식입니다. 이 응답 코드는 HTTP 415 "지원되지 않는 미디어 유형"에 해당합니다. |
QtCoap::ResponseCode::InternalServerFault | 0x-60 | 서버가 요청을 처리할 수 없는 예기치 않은 조건이 발생했습니다. 이 응답 코드는 HTTP 500 "내부 서버 오류"에 해당합니다. |
QtCoap::ResponseCode::NotImplemented | 0x-5f | 서버가 요청을 처리하는 데 필요한 기능을 지원하지 않습니다. 이 응답 코드는 HTTP 501 "구현되지 않음"에 해당합니다. |
QtCoap::ResponseCode::BadGateway | 0x-5e | 업스트림 서버에서 오류가 발생했습니다. 이 응답 코드는 HTTP 502 "잘못된 게이트웨이"에 해당합니다. |
QtCoap::ResponseCode::ServiceUnavailable | 0x-5d | 현재 서비스를 사용할 수 없습니다. 이 응답 코드는 HTTP 503 "서비스를 사용할 수 없음"에 해당합니다. |
QtCoap::ResponseCode::GatewayTimeout | 0x-5c | 서버가 게이트웨이 또는 프록시 역할을 하는 동안 업스트림 서버로부터 적시에 응답을 받지 못했습니다. 이 응답 코드는 HTTP 504 "게이트웨이 시간 초과"에 해당합니다. |
QtCoap::ResponseCode::ProxyingNotSupported | 0x-5b | 서버가 Proxy-Uri 옵션에 지정된 URI에 대한 정방향 프록시 역할을 할 수 없거나 원하지 않거나 Proxy-Scheme에 지정된 스키마를 사용하고 있습니다. |
QtCoap::ResponseCode::InvalidCode | 0xFF | 잘못된 응답 코드입니다. |
enum class QtCoap::SecurityMode
RFC 7252에 정의된 대로 CoAP 연결을 보호하는 데 사용되는 보안 모드를 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
QtCoap::SecurityMode::NoSecurity | 0 | 프로토콜 수준 보안이 없습니다(DTLS가 비활성화됨). |
QtCoap::SecurityMode::PreSharedKey | 1 | DTLS가 활성화됩니다. 보안을 위해 PSK 인증이 사용됩니다. |
QtCoap::SecurityMode::RawPublicKey | 2 | DTLS가 활성화됩니다. 보안을 위해 인증서가 없는 비대칭 키 쌍(원시 공개 키)이 사용됩니다. 이 모드는 아직 지원되지 않습니다. |
QtCoap::SecurityMode::Certificate | 3 | DTLS가 사용 설정되었습니다. X.509 인증서가 있는 비대칭 키 쌍이 보안을 위해 사용됩니다. |
© 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.
