이 페이지에서

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)

상세 설명

JSON 객체를 직렬화하는 오버로드를 사용하여 HTTP 클라이언트에 데이터를 다시 쓰기 위한 함수를 제공합니다. 또한 HTTP 헤더 및 상태 코드 쓰기를 지원합니다.

멤버 유형 설명

enum class QHttpServerResponder::StatusCode

HTTP 상태 코드

상수값
QHttpServerResponder::StatusCode::Continue100
QHttpServerResponder::StatusCode::SwitchingProtocols101
QHttpServerResponder::StatusCode::Processing102
QHttpServerResponder::StatusCode::Ok200
QHttpServerResponder::StatusCode::Created201
QHttpServerResponder::StatusCode::Accepted202
QHttpServerResponder::StatusCode::NonAuthoritativeInformation203
QHttpServerResponder::StatusCode::NoContent204
QHttpServerResponder::StatusCode::ResetContent205
QHttpServerResponder::StatusCode::PartialContent206
QHttpServerResponder::StatusCode::MultiStatus207
QHttpServerResponder::StatusCode::AlreadyReported208
QHttpServerResponder::StatusCode::IMUsed226
QHttpServerResponder::StatusCode::MultipleChoices300
QHttpServerResponder::StatusCode::MovedPermanently301
QHttpServerResponder::StatusCode::Found302
QHttpServerResponder::StatusCode::SeeOther303
QHttpServerResponder::StatusCode::NotModified304
QHttpServerResponder::StatusCode::UseProxy305
QHttpServerResponder::StatusCode::TemporaryRedirect307
QHttpServerResponder::StatusCode::PermanentRedirect308
QHttpServerResponder::StatusCode::BadRequest400
QHttpServerResponder::StatusCode::Unauthorized401
QHttpServerResponder::StatusCode::PaymentRequired402
QHttpServerResponder::StatusCode::Forbidden403
QHttpServerResponder::StatusCode::NotFound404
QHttpServerResponder::StatusCode::MethodNotAllowed405
QHttpServerResponder::StatusCode::NotAcceptable406
QHttpServerResponder::StatusCode::ProxyAuthenticationRequired407
QHttpServerResponder::StatusCode::RequestTimeout408
QHttpServerResponder::StatusCode::Conflict409
QHttpServerResponder::StatusCode::Gone410
QHttpServerResponder::StatusCode::LengthRequired411
QHttpServerResponder::StatusCode::PreconditionFailed412
QHttpServerResponder::StatusCode::PayloadTooLarge413
QHttpServerResponder::StatusCode::UriTooLong414
QHttpServerResponder::StatusCode::UnsupportedMediaType415
QHttpServerResponder::StatusCode::RequestRangeNotSatisfiable416
QHttpServerResponder::StatusCode::ExpectationFailed417
QHttpServerResponder::StatusCode::ImATeapot418
QHttpServerResponder::StatusCode::MisdirectedRequest421
QHttpServerResponder::StatusCode::UnprocessableEntity422
QHttpServerResponder::StatusCode::Locked423
QHttpServerResponder::StatusCode::FailedDependency424
QHttpServerResponder::StatusCode::UpgradeRequired426
QHttpServerResponder::StatusCode::PreconditionRequired428
QHttpServerResponder::StatusCode::TooManyRequests429
QHttpServerResponder::StatusCode::RequestHeaderFieldsTooLarge431
QHttpServerResponder::StatusCode::UnavailableForLegalReasons451
QHttpServerResponder::StatusCode::InternalServerError500
QHttpServerResponder::StatusCode::NotImplemented501
QHttpServerResponder::StatusCode::BadGateway502
QHttpServerResponder::StatusCode::ServiceUnavailable503
QHttpServerResponder::StatusCode::GatewayTimeout504
QHttpServerResponder::StatusCode::HttpVersionNotSupported505
QHttpServerResponder::StatusCode::VariantAlsoNegotiates506
QHttpServerResponder::StatusCode::InsufficientStorage507
QHttpServerResponder::StatusCode::LoopDetected508
QHttpServerResponder::StatusCode::NotExtended510
QHttpServerResponder::StatusCode::NetworkAuthenticationRequired511
QHttpServerResponder::StatusCode::NetworkConnectTimeoutError599

멤버 함수 설명서

[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.