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.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.5] void QHttpServerResponder::sendResponse(const QHttpServerResponse &response)

클라이언트에 HTTP response 를 전송합니다.

이 함수는 Qt 6.5에 도입되었습니다.

[noexcept, since 6.8] void QHttpServerResponder::swap(QHttpServerResponder &other)

QHttpServerResponder otherQHttpServerResponder 으로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

이 기능은 Qt 6.8에 도입되었습니다.

void QHttpServerResponder::write(QHttpServerResponder::StatusCode status = StatusCode::Ok)

HTTP 상태 코드 status 로 요청에 응답합니다.

참고: 이 함수는 HTTP 콘텐츠 유형 헤더를 "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)

HTTP 상태 코드 status 와 JSON 문서 document 로 요청에 응답합니다.

참고: 이 함수는 HTTP 콘텐츠 유형 헤더를 "application/json"으로 설정합니다.

void QHttpServerResponder::write(QIODevice *data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)

HTTP 상태 코드 status 및 MIME 유형 mimeType 으로 요청에 응답합니다. I/O 장치 data 는 응답의 본문을 제공합니다. data 이 순차적이면 메시지 본문이 청크로 전송되고, 그렇지 않으면 모든 콘텐츠를 사용할 수 있다고 가정하고 한 번에 모두 전송하지만 읽기는 청크로 수행됩니다.

참고: 이 함수는 data 의 소유권을 사용합니다.

void QHttpServerResponder::write(QIODevice *data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)

HTTP 상태 코드 status 및 HTTP 헤더 headers 로 요청에 응답합니다. 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)

HTTP 상태 코드 status, HTTP 헤더 headers 및 본문 data 으로 요청에 응답합니다.

참고: 이 함수는 HTTP Content-Length 헤더를 설정합니다.

void QHttpServerResponder::write(const QJsonDocument &document, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)

HTTP 상태 코드 status, JSON 문서 document 및 HTTP 헤더 headers 로 요청에 응답합니다.

참고: 이 함수는 HTTP 콘텐츠 유형 헤더를 "application/json"으로 설정합니다.

[since 6.8] void QHttpServerResponder::writeBeginChunked(const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)

mimeType 과 주어진 상태 코드 status 로 데이터 청크를 전송하기 시작합니다. 이 호출은 임의의 횟수의 반복된 writeChunk 호출과 writeEndChunked 으로의 단일 호출로 이어져야 합니다.

이 함수는 Qt 6.8에 도입되었습니다.

writeChunkwriteEndChunked도 참조하십시오 .

[since 6.8] void QHttpServerResponder::writeBeginChunked(const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)

headers 과 상태 코드 status 로 데이터 청크를 전송하기 시작합니다. 이 호출은 임의의 횟수의 반복된 writeChunk 호출과 writeEndChunked 으로의 단일 호출로 이어져야 합니다.

이 함수는 Qt 6.8에 도입되었습니다.

writeChunkwriteEndChunked도 참조하십시오 .

[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에 도입되었습니다.

writeChunkwriteEndChunked도 참조하십시오 .

[since 6.8] void QHttpServerResponder::writeChunk(const QByteArray &data)

data 을 클라이언트에 다시 씁니다. 데이터를 쓸 수 있을 때 호출됩니다. 이 함수는 여러 번 호출할 수 있지만, 호출하기 전에 writeBeginChunked 을 호출해야 하고, 호출 후에는 writeEndChunked 을 호출해야 합니다.

이 함수는 Qt 6.8에 도입되었습니다.

writeBeginChunkedwriteEndChunked도 참조하십시오 .

[since 6.8] void QHttpServerResponder::writeEndChunked(const QByteArray &data)

data 을 클라이언트에 회신합니다. writeBeginChunked 로 호출해야 합니다.

이 함수는 Qt 6.8에 도입되었습니다.

writeBeginChunkedwriteChunk도 참조하십시오 .

[since 6.8] void QHttpServerResponder::writeEndChunked(const QByteArray &data, const QHttpHeaders &trailers)

writeBeginChunked 에서 발표한 trailers 과 함께 data 을 클라이언트에 다시 보냅니다.

이 함수는 Qt 6.8에 도입되었습니다.

writeBeginChunkedwriteChunk참조하십시오 .

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