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 | 요청 헤더 필드에 지정된 하나 이상의 조건이 서버에서 테스트되었을 때 false로 평가되었습니다. |
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 요청 메서드를 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
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 멀티캐스트 그룹 주소를 나타냅니다.
| 상수 | 값 | 설명 |
|---|---|---|
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 포트 값을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QtCoap::DefaultPort | 5683 | 보안되지 않은 전송에 사용되는 기본 포트입니다. |
QtCoap::DefaultSecurePort | 5684 | 보안 전송에 사용되는 기본 포트입니다. |
enum class QtCoap::ResponseCode
이 열거형은 RFC 7252 및 RFC 7959에 정의된 대로 CoAP 프로토콜의 응답 코드를 나타냅니다.
| 상수 | 값 | 설명 |
|---|---|---|
QtCoap::ResponseCode::EmptyMessage | 0x00 | 메시지가 비어 있을 때의 응답 코드입니다. |
QtCoap::ResponseCode::Created | 0x41 | 요청이 성공하여 새로운 리소스가 생성되었습니다. 이 응답 코드는 HTTP 201 "Created"에 해당합니다. |
QtCoap::ResponseCode::Deleted | 0x42 | 리소스가 성공적으로 삭제되었습니다. 이 응답 코드는 HTTP 204 "No Content"에 해당하지만, DELETE 및 특정 상황에서 POST와 같이 리소스가 더 이상 사용 불가능하게 되는 요청에 대한 응답으로만 사용됩니다. |
QtCoap::ResponseCode::Valid | 0x43 | 이 응답 코드는 HTTP 304 "Not Modified"와 관련이 있지만, ETag 옵션에 지정된 엔티티 태그로 식별된 응답이 유효함을 나타내는 데에만 사용됩니다. |
QtCoap::ResponseCode::Changed | 0x44 | 리소스가 성공적으로 수정되었습니다. 이 응답 코드는 HTTP 204 "No Content"에 해당하지만, POST 및 PUT 요청에 대한 응답으로만 사용됩니다. |
QtCoap::ResponseCode::Content | 0x45 | 요청이 성공했습니다. 이 응답 코드는 HTTP 200 "OK"에 해당하지만, GET 요청에 대한 응답으로만 사용됩니다. |
QtCoap::ResponseCode::Continue | 0x5F | 현재 블록의 전송이 성공했으며, 서버가 더 많은 블록을 보낼 것임을 나타냅니다. |
QtCoap::ResponseCode::BadRequest | 0x-80 | 요청이 인식되지 않았습니다. 이 응답 코드는 HTTP 400 "Bad Request"에 해당합니다. |
QtCoap::ResponseCode::Unauthorized | 0x-7f | 클라이언트가 요청된 작업을 수행할 권한이 없습니다. 이 응답 코드는 HTTP 401 "Unauthorized"에 해당합니다. |
QtCoap::ResponseCode::BadOption | 0x-7e | 알 수 없는 옵션으로 인해 서버에서 요청을 이해할 수 없었습니다. |
QtCoap::ResponseCode::Forbidden | 0x-7d | 이 리소스에 대한 액세스가 금지되었습니다. 이 응답 코드는 HTTP 403 “Forbidden”에 해당합니다. |
QtCoap::ResponseCode::NotFound | 0x-7c | 요청된 리소스를 찾을 수 없습니다. 이 응답 코드는 HTTP 404 "Not Found"에 해당합니다. |
QtCoap::ResponseCode::MethodNotAllowed | 0x-7b | 서버는 요청된 URL에 사용된 메서드를 허용하지 않습니다. 이 응답 코드는 HTTP 405 "Method Not Allowed"에 해당하지만, "Allow" 헤더 필드와의 대응 관계는 없습니다. |
QtCoap::ResponseCode::NotAcceptable | 0x-7a | 요청의 수용 기준을 충족하는 리소스를 찾을 수 없습니다. 이 응답 코드는 HTTP 406 “Not Acceptable”에 해당하지만, 응답 엔티티는 없습니다. |
QtCoap::ResponseCode::RequestEntityIncomplete | 0x-78 | 서버가 처리를 진행하는 데 필요한 요청 본문의 모든 블록을 수신하지 못했습니다. |
QtCoap::ResponseCode::PreconditionFailed | 0x-74 | 요청 헤더 필드에 지정된 전제 조건이 서버에서 테스트되었을 때 ' false '로 평가되었습니다. 이 응답 코드는 HTTP 412 "Precondition Failed"에 해당합니다. |
QtCoap::ResponseCode::RequestEntityTooLarge | 0x-73 | 요청 페이로드의 크기가 서버가 처리할 수 있거나 처리하려는 크기보다 큽니다. 이 응답 코드는 HTTP 413 "Request Entity Too Large"에 해당합니다. |
QtCoap::ResponseCode::UnsupportedContentFormat | 0x-72 | 페이로드의 형식이 대상 리소스의 해당 메서드에서 지원되지 않습니다. 이 응답 코드는 HTTP 415 "Unsupported Media Type"에 해당합니다. |
QtCoap::ResponseCode::InternalServerFault | 0x-60 | 서버에서 예기치 않은 상황이 발생하여 요청을 처리할 수 없었습니다. 이 응답 코드는 HTTP 500 "Internal Server Error"에 해당합니다. |
QtCoap::ResponseCode::NotImplemented | 0x-5f | 서버가 요청을 처리하는 데 필요한 기능을 지원하지 않습니다. 이 응답 코드는 HTTP 501 "Not Implemented"에 해당합니다. |
QtCoap::ResponseCode::BadGateway | 0x-5e | 상위 서버에서 오류가 발생했습니다. 이 응답 코드는 HTTP 502 "Bad Gateway"에 해당합니다. |
QtCoap::ResponseCode::ServiceUnavailable | 0x-5d | 현재 서비스를 이용할 수 없습니다. 이 응답 코드는 HTTP 503 "Service Unavailable"에 해당합니다. |
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 연결을 보호하는 데 사용되는 보안 모드를 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QtCoap::SecurityMode::NoSecurity | 0 | 프로토콜 수준의 보안이 없습니다(DTLS가 비활성화됨). |
QtCoap::SecurityMode::PreSharedKey | 1 | DTLS가 활성화됩니다. 보안을 위해 PSK 인증이 사용됩니다. |
QtCoap::SecurityMode::RawPublicKey | 2 | DTLS가 활성화되어 있습니다. 보안을 위해 인증서가 없는 비대칭 키 쌍(원시 공개 키)이 사용됩니다. 이 모드는 아직 지원되지 않습니다. |
QtCoap::SecurityMode::Certificate | 3 | DTLS가 활성화되어 있습니다. 보안을 위해 X.509 인증서가 포함된 비대칭 키 쌍이 사용됩니다. |
© 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.
