QNetworkRequest Class

멤버 함수 문서

QNetworkRequest::QNetworkRequest()

요청할 URL이 없는 QNetworkRequest 객체를 생성합니다. setUrl ()를 사용하여 설정합니다.

url() 및 setUrl()도 참조하세요 .

[explicit] QNetworkRequest::QNetworkRequest(const QUrl &url)

요청할 URL을 url 로 사용하여 QNetworkRequest 객체를 구축합니다.

url() 및 setUrl()도 참조하세요 .

QNetworkRequest::QNetworkRequest(const QNetworkRequest &other)

other 의 복사본을 만듭니다.

[noexcept] QNetworkRequest::~QNetworkRequest()

QNetworkRequest 개체를 폐기합니다.

QVariant QNetworkRequest::attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const

코드와 연관된 속성을 반환합니다 code. 속성이 설정되지 않은 경우 defaultValue 을 반환합니다.

setAttribute() 및 QNetworkRequest::Attribute 을참조하세요 .

[since 6.2] qint64 QNetworkRequest::decompressedSafetyCheckThreshold() const

아카이브 폭탄 검사 임계값을 반환합니다.

압축 해제된 응답의 크기가 이보다 작으면 Qt는 추가 검사 없이 압축을 해제합니다.

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

setDecompressedSafetyCheckThreshold()도 참조하십시오 .

bool QNetworkRequest::hasRawHeader(QAnyStringView headerName) const

이 네트워크 요청에 원시 헤더 headerName 가 있는 경우 true 를 반환합니다.

rawHeader() 및 setRawHeader()도 참조하세요 .

QVariant QNetworkRequest::header(QNetworkRequest::KnownHeaders header) const

이 요청에 알려진 네트워크 헤더가 있으면 header 값을 반환합니다. 존재하지 않으면 QVariant()(즉, 유효하지 않은 변형)를 반환합니다.

KnownHeaders, rawHeader() 및 setHeader()도 참조하세요 .

[since 6.8] QHttpHeaders QNetworkRequest::headers() const

이 네트워크 요청에 설정된 헤더를 반환합니다.

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

setHeaders()도 참조하십시오 .

[since 6.5] QHttp1Configuration QNetworkRequest::http1Configuration() const

QNetworkAccessManager 이 요청의 기본 HTTP/1 연결에 사용하고 있는 현재 매개변수를 반환합니다.

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

setHttp1Configuration 를참조하세요 .

QHttp2Configuration QNetworkRequest::http2Configuration() const

QNetworkAccessManager 이 요청과 기본 HTTP/2 연결에 사용하고 있는 현재 매개변수를 반환합니다. 이는 애플리케이션에서 이전에 설정한 구성이거나 기본 구성입니다.

QNetworkAccessManager 에서 사용하는 기본값은 다음과 같습니다:

• 연결 수준 흐름 제어의 창 크기: 2147483647 옥텟
• 스트림 수준 흐름 제어의 창 크기는 214748364 옥텟입니다.
• 최대 프레임 크기는 16384입니다.

기본적으로 서버 푸시는 비활성화되어 있고, 허프만 압축 및 문자열 인덱싱은 활성화되어 있습니다.

setHttp2Configuration 을참조하세요 .

int QNetworkRequest::maximumRedirectsAllowed() const

이 요청에 대해 따를 수 있는 최대 리디렉션 수를 반환합니다.

setMaximumRedirectsAllowed()도 참조하세요 .

QObject *QNetworkRequest::originatingObject() const

이 네트워크 요청을 시작한 객체에 대한 참조를 반환합니다. 설정되지 않았거나 객체가 삭제된 경우 nullptr 을 반환합니다.

setOriginatingObject()도 참조하세요 .

QString QNetworkRequest::peerVerifyName() const

인증서 유효성 검사에 설정된 호스트 이름을 setPeerVerifyName 에 설정된 대로 반환합니다. 기본적으로 이 함수는 널 문자열을 반환합니다.

setPeerVerifyName도 참조하세요 .

QNetworkRequest::Priority QNetworkRequest::priority() const

이 요청의 우선순위를 반환합니다.

setPriority()도 참조하세요 .

QByteArray QNetworkRequest::rawHeader(QAnyStringView headerName) const

원시 형태의 헤더 headerName 를 반환합니다. 이러한 헤더가 없으면 빈 QByteArray 이 반환되며, 이는 존재하지만 콘텐츠가 없는 헤더와 구별할 수 없습니다(헤더의 존재 여부를 확인하려면 hasRawHeader()를 사용하세요).

원시 헤더는 setRawHeader() 또는 setHeader()로 설정할 수 있습니다.

header() 및 setRawHeader()도 참조하세요 .

QList<QByteArray> QNetworkRequest::rawHeaderList() const

이 네트워크 요청에 설정된 모든 원시 헤더의 목록을 반환합니다. 목록은 헤더가 설정된 순서대로 나열됩니다.

hasRawHeader() 및 rawHeader()도 참조하세요 .

void QNetworkRequest::setAttribute(QNetworkRequest::Attribute code, const QVariant &value)

코드 code 와 연결된 속성을 값 value 으로 설정합니다. 속성이 이미 설정되어 있으면 이전 값은 무시됩니다. 특히 value 가 잘못된 QVariant 인 경우 속성이 설정 해제됩니다.

attribute() 및 QNetworkRequest::Attribute도 참조하세요 .

[since 6.2] void QNetworkRequest::setDecompressedSafetyCheckThreshold(qint64 threshold)

아카이브 폭탄 검사를 위해 threshold 을 설정합니다.

일부 지원되는 압축 알고리즘은 작은 압축 파일로 엄청나게 큰 압축 해제 파일을 인코딩할 수 있습니다. 이는 압축 해제된 콘텐츠가 극도로 단조로운 경우에만 가능하며, 실제 파일이 선의로 전송되는 경우는 거의 없습니다. 이렇게 엄청나게 높은 압축률을 적용하는 파일은 일반적으로 버퍼 오버런 공격 또는 서비스 거부(너무 많은 메모리 사용) 공격의 페이로드가 됩니다. 따라서 특히 작은 압축 파일에서 엄청난 크기로 압축이 해제되는 파일은 멀웨어로 의심되는 파일로 거부하는 것이 가장 좋습니다.

응답의 압축 해제 크기가 이 임계값(기본값은 10 MiB, 즉 10 * 1024 * 1024)보다 큰 경우 Qt는 압축 비율을 확인합니다. 압축 비율이 부당하게 큰 경우(GZip 및 Deflate의 경우 40:1, Brotli 및 ZStandard의 경우 100:1) 응답은 오류로 처리됩니다. 임계값을 -1 으로 설정하면 이 검사가 비활성화됩니다.

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

decompressedSafetyCheckThreshold()도 참조하세요 .

void QNetworkRequest::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)

알려진 헤더 header 의 값을 value 으로 설정하여 이전에 설정된 모든 헤더를 재정의합니다. 이 작업은 동등한 원시 HTTP 헤더도 설정합니다.

KnownHeaders, setRawHeader() 및 header()도 참조하세요 .

[since 6.8] void QNetworkRequest::setHeaders(QHttpHeaders &&newHeaders)

이 네트워크 요청의 헤더로 newHeaders 을 설정하여 이전에 설정된 모든 헤더를 재정의합니다.

일부 헤더가 알려진 헤더에 해당하는 경우 값을 구문 분석하고 해당 구문 분석된 형식도 설정합니다.

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

headers() 및 KnownHeaders 을참조하세요 .

[since 6.8] void QNetworkRequest::setHeaders(const QHttpHeaders &newHeaders)

이 함수는 오버로드된 함수입니다.

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

[since 6.5] void QNetworkRequest::setHttp1Configuration(const QHttp1Configuration &configuration)

configuration 에서 요청의 HTTP/1 파라미터를 설정합니다.

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

http1Configuration, QNetworkAccessManager, QHttp1Configuration 를참고하세요 .

void QNetworkRequest::setHttp2Configuration(const QHttp2Configuration &configuration)

configuration 에서 요청의 HTTP/2 매개변수를 설정합니다.

http2Configuration, QNetworkAccessManager, QHttp2Configuration 를참조하세요 .

void QNetworkRequest::setMaximumRedirectsAllowed(int maxRedirectsAllowed)

이 요청에 대해 허용되는 최대 리디렉션 수를 maxRedirectsAllowed 로 설정합니다.

maximumRedirectsAllowed()도 참조하세요 .

void QNetworkRequest::setOriginatingObject(QObject *object)

요청을 시작한 object 에 대한 참조를 설정할 수 있습니다.

예를 들어 Qt WebKit은 원본 객체를 요청을 시작한 QWebFrame으로 설정합니다.

originatingObject()도 참조하십시오 .

void QNetworkRequest::setPeerVerifyName(const QString &peerName)

인증서 유효성 검사를 위한 호스트 이름을 TCP 연결에 사용되는 이름 대신 peerName 로 설정합니다.

peerVerifyName 를참조하세요 .

void QNetworkRequest::setPriority(QNetworkRequest::Priority priority)

이 요청의 우선순위를 priority 로 설정합니다.

priority()도 참조하세요 .

void QNetworkRequest::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)

headerName 헤더를 headerValue 값으로 설정합니다. headerName 이 알려진 헤더에 해당하는 경우( QNetworkRequest::KnownHeaders 참조 ), 원시 형식이 구문 분석되고 해당 "쿠킹된" 헤더도 설정됩니다.

예를 들어

request.setRawHeader(QByteArray("Last-Modified"), QByteArray("Sun, 06 Nov 1994 08:49:37 GMT"));

는 알려진 헤더 LastModifiedHeader 를 구문 분석된 날짜의 QDateTime 객체로 설정합니다.

KnownHeaders, setHeader(), hasRawHeader() 및 rawHeader()도 참조하세요 .

void QNetworkRequest::setSslConfiguration(const QSslConfiguration &config)

이 네트워크 요청의 SSL 구성을 config 로 설정합니다. 적용되는 설정은 개인 키, 로컬 인증서, TLS 프로토콜(예: TLS 1.3), CA 인증서 및 SSL 백엔드에서 사용할 수 있는 암호입니다.

sslConfiguration() 및 QSslConfiguration::defaultConfiguration()도 참조하세요 .

void QNetworkRequest::setTransferTimeout(int timeout)

timeout 을 밀리초 단위의 전송 시간 초과로 설정합니다.

setTransferTimeout(표준::크로노::밀리초), transferTimeout() 및 transferTimeoutAsDuration()도 참조하세요 .

[since 6.7] void QNetworkRequest::setTransferTimeout(std::chrono::milliseconds duration = DefaultTransferTimeout)

데이터가 교환되지 않으면 전송을 중단하는 시간 제한( duration )을 설정합니다.

타임아웃이 만료되기 전에 전송된 바이트가 없으면 전송이 중단됩니다. 0은 타이머가 설정되지 않았음을 의미합니다. 인수가 제공되지 않으면 타임아웃은 QNetworkRequest::DefaultTransferTimeout 입니다. 이 함수를 호출하지 않으면 타임아웃이 비활성화되고 0 값이 됩니다.

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

transferTimeoutAsDuration()도 참조하세요 .

void QNetworkRequest::setUrl(const QUrl &url)

이 네트워크 요청이 참조하는 URL을 url 으로 설정합니다.

url()도 참조하세요 .

QSslConfiguration QNetworkRequest::sslConfiguration() const

이 네트워크 요청의 SSL 구성을 반환합니다. 기본적으로 QSslConfiguration::defaultConfiguration()와 동일합니다.

setSslConfiguration() 및 QSslConfiguration::defaultConfiguration()도 참조하세요 .

[noexcept] void QNetworkRequest::swap(QNetworkRequest &other)

이 네트워크 요청을 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

int QNetworkRequest::transferTimeout() const

전송에 사용된 시간제한을 밀리초 단위로 반환합니다.

transferTimeoutAsDuration().count()를 int 으로 표현할 수 없는 경우 이 함수는 대신 INT_MAX/INT_MIN 을 반환합니다.

setTransferTimeout() 및 transferTimeoutAsDuration()도 참조하세요 .

[since 6.7] std::chrono::milliseconds QNetworkRequest::transferTimeoutAsDuration() const

데이터가 교환되지 않으면 전송이 중단되는 시간 초과 기간을 반환합니다.

기본 기간은 0이며, 이는 타임아웃이 사용되지 않음을 의미합니다.

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

setTransferTimeout(표준::크로노::밀리초)도 참조하세요 .

QUrl QNetworkRequest::url() const

이 네트워크 요청이 참조하는 URL을 반환합니다.

setUrl()도 참조하세요 .

bool QNetworkRequest::operator!=(const QNetworkRequest &other) const

이 객체가 other 과 같지 않으면 false 을 반환합니다.

operator==()도 참조하세요 .

QNetworkRequest &QNetworkRequest::operator=(const QNetworkRequest &other)

의 복사본을 만듭니다. other

bool QNetworkRequest::operator==(const QNetworkRequest &other) const

이 객체가 other 과 동일한 경우(즉, URL, 헤더 및 메타데이터 설정이 동일한 경우) true 을 반환합니다.

operator!=()도 참조하세요 .