QHttpServerResponder Class
HTTP 서버에서 응답을 전송하기 위한 API. 더 보기...
| 헤더: | #include <QHttpServerResponder> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS HttpServer) target_link_libraries(mytarget PRIVATE Qt6::HttpServer) |
| qmake: | QT += httpserver |
| 다음과 같이: | Qt 6.4부터 |
공개 유형
| enum class | StatusCode { Continue, SwitchingProtocols, Processing, Ok, Created, …, NetworkConnectTimeoutError } |
공개 함수
| QHttpServerResponder(QHttpServerResponder &&other) | |
| ~QHttpServerResponder() | |
(since 6.11) bool | isResponseCanceled() const |
(since 6.5) void | sendResponse(const QHttpServerResponse &response) |
(since 6.8) void | swap(QHttpServerResponder &other) |
| void | write(QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QJsonDocument &document, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(QIODevice *data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(QIODevice *data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QByteArray &data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QByteArray &data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QJsonDocument &document, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
(since 6.8) void | writeBeginChunked(const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
(since 6.8) void | writeBeginChunked(const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
(since 6.8) void | writeBeginChunked(const QHttpHeaders &headers, QList<QHttpHeaders::WellKnownHeader> trailers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
(since 6.8) void | writeChunk(const QByteArray &data) |
(since 6.8) void | writeEndChunked(const QByteArray &data) |
(since 6.8) void | writeEndChunked(const QByteArray &data, const QHttpHeaders &trailers) |
멤버 유형 설명
enum class QHttpServerResponder::StatusCode
HTTP 상태 코드
| 상수 | 값 |
|---|---|
QHttpServerResponder::StatusCode::Continue | 100 |
QHttpServerResponder::StatusCode::SwitchingProtocols | 101 |
QHttpServerResponder::StatusCode::Processing | 102 |
QHttpServerResponder::StatusCode::Ok | 200 |
QHttpServerResponder::StatusCode::Created | 201 |
QHttpServerResponder::StatusCode::Accepted | 202 |
QHttpServerResponder::StatusCode::NonAuthoritativeInformation | 203 |
QHttpServerResponder::StatusCode::NoContent | 204 |
QHttpServerResponder::StatusCode::ResetContent | 205 |
QHttpServerResponder::StatusCode::PartialContent | 206 |
QHttpServerResponder::StatusCode::MultiStatus | 207 |
QHttpServerResponder::StatusCode::AlreadyReported | 208 |
QHttpServerResponder::StatusCode::IMUsed | 226 |
QHttpServerResponder::StatusCode::MultipleChoices | 300 |
QHttpServerResponder::StatusCode::MovedPermanently | 301 |
QHttpServerResponder::StatusCode::Found | 302 |
QHttpServerResponder::StatusCode::SeeOther | 303 |
QHttpServerResponder::StatusCode::NotModified | 304 |
QHttpServerResponder::StatusCode::UseProxy | 305 |
QHttpServerResponder::StatusCode::TemporaryRedirect | 307 |
QHttpServerResponder::StatusCode::PermanentRedirect | 308 |
QHttpServerResponder::StatusCode::BadRequest | 400 |
QHttpServerResponder::StatusCode::Unauthorized | 401 |
QHttpServerResponder::StatusCode::PaymentRequired | 402 |
QHttpServerResponder::StatusCode::Forbidden | 403 |
QHttpServerResponder::StatusCode::NotFound | 404 |
QHttpServerResponder::StatusCode::MethodNotAllowed | 405 |
QHttpServerResponder::StatusCode::NotAcceptable | 406 |
QHttpServerResponder::StatusCode::ProxyAuthenticationRequired | 407 |
QHttpServerResponder::StatusCode::RequestTimeout | 408 |
QHttpServerResponder::StatusCode::Conflict | 409 |
QHttpServerResponder::StatusCode::Gone | 410 |
QHttpServerResponder::StatusCode::LengthRequired | 411 |
QHttpServerResponder::StatusCode::PreconditionFailed | 412 |
QHttpServerResponder::StatusCode::PayloadTooLarge | 413 |
QHttpServerResponder::StatusCode::UriTooLong | 414 |
QHttpServerResponder::StatusCode::UnsupportedMediaType | 415 |
QHttpServerResponder::StatusCode::RequestRangeNotSatisfiable | 416 |
QHttpServerResponder::StatusCode::ExpectationFailed | 417 |
QHttpServerResponder::StatusCode::ImATeapot | 418 |
QHttpServerResponder::StatusCode::MisdirectedRequest | 421 |
QHttpServerResponder::StatusCode::UnprocessableEntity | 422 |
QHttpServerResponder::StatusCode::Locked | 423 |
QHttpServerResponder::StatusCode::FailedDependency | 424 |
QHttpServerResponder::StatusCode::UpgradeRequired | 426 |
QHttpServerResponder::StatusCode::PreconditionRequired | 428 |
QHttpServerResponder::StatusCode::TooManyRequests | 429 |
QHttpServerResponder::StatusCode::RequestHeaderFieldsTooLarge | 431 |
QHttpServerResponder::StatusCode::UnavailableForLegalReasons | 451 |
QHttpServerResponder::StatusCode::InternalServerError | 500 |
QHttpServerResponder::StatusCode::NotImplemented | 501 |
QHttpServerResponder::StatusCode::BadGateway | 502 |
QHttpServerResponder::StatusCode::ServiceUnavailable | 503 |
QHttpServerResponder::StatusCode::GatewayTimeout | 504 |
QHttpServerResponder::StatusCode::HttpVersionNotSupported | 505 |
QHttpServerResponder::StatusCode::VariantAlsoNegotiates | 506 |
QHttpServerResponder::StatusCode::InsufficientStorage | 507 |
QHttpServerResponder::StatusCode::LoopDetected | 508 |
QHttpServerResponder::StatusCode::NotExtended | 510 |
QHttpServerResponder::StatusCode::NetworkAuthenticationRequired | 511 |
QHttpServerResponder::StatusCode::NetworkConnectTimeoutError | 599 |
멤버 함수 설명서
[noexcept] QHttpServerResponder::QHttpServerResponder(QHttpServerResponder &&other)
QHttpServerResponder 인스턴스를 생성하여, 이 인스턴스가 other 이 가리키던 것과 동일한 객체를 가리키도록 합니다.
[noexcept] QHttpServerResponder::~QHttpServerResponder()
QHttpServerResponder 를 삭제합니다.
[since 6.11] bool QHttpServerResponder::isResponseCanceled() const
클라이언트가 응답을 취소한 경우 true를 반환합니다. 응답이 취소되었을 때 핸들러에서 조기에 종료할 수 있도록 하는 데 사용됩니다.
이 함수는 Qt 6.11에서 도입되었습니다.
[since 6.5] void QHttpServerResponder::sendResponse(const QHttpServerResponse &response)
클라이언트에게 HTTP response 요청을 보냅니다.
이 함수는 Qt 6.5에서 도입되었습니다.
[noexcept, since 6.8] void QHttpServerResponder::swap(QHttpServerResponder &other)
QHttpServerResponder other 를 이 QHttpServerResponder 로 바꿉니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.
이 함수는 Qt 6.8에서 도입되었습니다.
void QHttpServerResponder::write(QHttpServerResponder::StatusCode status = StatusCode::Ok)
status HTTP 상태 코드로 요청에 응답합니다.
참고: 이 함수는 HTTP Content-Type 헤더를 "application/x-empty" 로 설정합니다.
void QHttpServerResponder::write(const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
요청에 대해 HTTP 상태 코드 status 및 HTTP 헤더 headers 를 반환합니다.
void QHttpServerResponder::write(const QJsonDocument &document, QHttpServerResponder::StatusCode status = StatusCode::Ok)
status HTTP 상태 코드와 document JSON 문서를 사용하여 요청에 응답합니다.
참고: 이 함수는 HTTP Content-Type 헤더를 "application/json" 로 설정합니다.
void QHttpServerResponder::write(QIODevice *data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)
status HTTP 상태 코드와 mimeType MIME 유형을 사용하여 요청에 응답합니다. I/O 장치 data 가 응답 본문을 제공합니다. data 가 순차적일 경우, 메시지 본문은 청크 단위로 전송됩니다. 그렇지 않은 경우, 이 함수는 모든 콘텐츠가 사용 가능하다고 가정하고 한 번에 모두 전송하지만, 읽기는 청크 단위로 수행됩니다.
참고: 이 함수는 data 에 대한 소유권을 인수합니다.
void QHttpServerResponder::write(QIODevice *data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
status HTTP 상태 코드와 headers HTTP 헤더를 사용하여 요청에 응답합니다. I/O 장치 data 가 응답 본문을 제공합니다. data 가 순차적일 경우, 메시지 본문은 청크 단위로 전송됩니다. 그렇지 않은 경우, 이 함수는 모든 콘텐츠가 사용 가능한 것으로 간주하여 한 번에 모두 전송하지만, 읽기는 청크 단위로 수행됩니다.
참고: 이 함수는 data 의 소유권을 인수합니다.
void QHttpServerResponder::write(const QByteArray &data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)
요청에 대해 HTTP 상태 코드 status, MIME 유형 mimeType 및 본문 data 을 반환합니다.
void QHttpServerResponder::write(const QByteArray &data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
status HTTP 상태 코드, headers HTTP 헤더 및 data 본문을 포함하여 요청에 응답합니다.
참고: 이 함수는 HTTP Content-Length 헤더를 설정합니다.
void QHttpServerResponder::write(const QJsonDocument &document, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
status HTTP 상태 코드, document JSON 문서 및 headers HTTP 헤더를 사용하여 요청에 응답합니다.
참고: 이 함수는 HTTP Content-Type 헤더를 "application/json" 로 설정합니다.
[since 6.8] void QHttpServerResponder::writeBeginChunked(const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)
MIME 유형 mimeType 및 지정된 상태 코드 status 을 사용하여 데이터 청크를 전송하기 시작합니다. 이 호출 후에는 임의의 횟수만큼 writeChunk 호출을 반복하고, writeEndChunked 호출을 한 번 수행해야 합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
writeChunk 및 writeEndChunked도 참조하십시오 .
[since 6.8] void QHttpServerResponder::writeBeginChunked(const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
headers 를 사용하여 데이터 청크를 전송하기 시작하고, 상태 코드 status 를 지정하십시오. 이 호출 후에는 writeChunk 호출을 임의의 횟수만큼 반복하고, writeEndChunked 호출을 한 번 수행해야 합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
writeChunk 및 writeEndChunked도 참조하십시오 .
[since 6.8] void QHttpServerResponder::writeBeginChunked(const QHttpHeaders &headers, QList<QHttpHeaders::WellKnownHeader> trailers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
headers 및 지정된 상태 코드 status 를 사용하여 데이터 청크를 전송하기 시작합니다. 이 호출 후에는 임의의 횟수만큼 writeChunk 호출을 반복하고, trailers 에 명시된 것과 동일한 트레일러를 사용하여 writeEndChunked 호출을 한 번 수행해야 합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
writeChunk 및 writeEndChunked도 참조하십시오 .
[since 6.8] void QHttpServerResponder::writeChunk(const QByteArray &data)
data 를 클라이언트에 다시 기록합니다. 기록할 데이터가 준비되었을 때 호출됩니다. 이 함수는 여러 번 호출될 수 있지만, 호출하기 전에 반드시 writeBeginChunked 를 호출해야 하며, 호출 후에는 writeEndChunked 를 호출해야 합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
writeBeginChunked 및 writeEndChunked도 참조하십시오 .
[since 6.8] void QHttpServerResponder::writeEndChunked(const QByteArray &data)
클라이언트에 ` data `을 다시 전송합니다. 반드시 ` writeBeginChunked` 호출이 선행되어야 합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
writeBeginChunked 및 writeChunk도 참조하십시오 .
[since 6.8] void QHttpServerResponder::writeEndChunked(const QByteArray &data, const QHttpHeaders &trailers)
writeBeginChunked 에서 발표된 trailers 를 사용하여 data 를 클라이언트에 다시 전송합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
writeBeginChunked 및 writeChunk도 참조하십시오 .
© 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.