Класс QNetworkRequest
Класс QNetworkRequest хранит запрос, который необходимо отправить с помощью QNetworkAccessManager. Подробнее...
| Заголовок: | #include <QNetworkRequest> |
| CMake: | find_package(Qt6 COMPONENTS Network REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
Типы публичного доступа
| Перечисление | Attribute { HttpStatusCodeAttribute, HttpReasonPhraseAttribute, RedirectionTargetAttribute, ConnectionEncryptedAttribute, CacheLoadControlAttribute, …, UserMax } |
| Перечисление | CacheLoadControl { AlwaysNetwork, PreferNetwork, PreferCache, AlwaysCache } |
| Перечисление | KnownHeaders { ContentDispositionHeader, ContentTypeHeader, ContentLengthHeader, LocationHeader, LastModifiedHeader, …, ServerHeader } |
| Перечисление | LoadControl { Automatic, Manual } |
| Перечисление | Priority { HighPriority, NormalPriority, LowPriority } |
| Перечисление | RedirectPolicy { ManualRedirectPolicy, NoLessSafeRedirectPolicy, SameOriginRedirectPolicy, UserVerifiedRedirectPolicy } |
| Перечисление | TransferTimeoutConstant { DefaultTransferTimeoutConstant } |
Публичные функции
| QNetworkRequest(const QNetworkRequest &other) | |
| QNetworkRequest(const QUrl &url) | |
| QNetworkRequest() | |
| QNetworkRequest & | operator=(const QNetworkRequest &other) |
| ~QNetworkRequest() | |
| QVariant | attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const |
| qint64 | decompressedSafetyCheckThreshold() const |
| bool | hasRawHeader(const QByteArray &headerName) const |
| QVariant | header(QNetworkRequest::KnownHeaders header) const |
| QHttp2Configuration | http2Configuration() const |
| int | maximumRedirectsAllowed() const |
| QObject * | originatingObject() const |
| QString | peerVerifyName() const |
| QNetworkRequest::Priority | priority() const |
| QByteArray | rawHeader(const QByteArray &headerName) const |
| QList<QByteArray> | rawHeaderList() const |
| void | setAttribute(QNetworkRequest::Attribute code, const QVariant &value) |
| void | setDecompressedSafetyCheckThreshold(qint64 threshold) |
| void | setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value) |
| void | setHttp2Configuration(const QHttp2Configuration &configuration) |
| void | setMaximumRedirectsAllowed(int maxRedirectsAllowed) |
| void | setOriginatingObject(QObject *object) |
| void | setPeerVerifyName(const QString &peerName) |
| void | setPriority(QNetworkRequest::Priority priority) |
| void | setRawHeader(const QByteArray &headerName, const QByteArray &headerValue) |
| void | setSslConfiguration(const QSslConfiguration &config) |
| void | setTransferTimeout(int timeout = DefaultTransferTimeoutConstant) |
| void | setUrl(const QUrl &url) |
| QSslConfiguration | sslConfiguration() const |
| void | swap(QNetworkRequest &other) |
| int | transferTimeout() const |
| QUrl | url() const |
| bool | operator!=(const QNetworkRequest &other) const |
| bool | operator==(const QNetworkRequest &other) const |
Подробное описание
QNetworkRequest является частью API сетевого доступа и представляет собой класс, содержащий информацию, необходимую для отправки запроса по сети. Он содержит URL-адрес и дополнительную информацию, которая может быть использована для изменения запроса.
См. также QNetworkReply и QNetworkAccessManager.
Документация по типам членов
перечисление QNetworkRequest::Attribute
Коды атрибутов для QNetworkRequest и QNetworkReply.
Атрибуты — это дополнительная метаданные, используемые для управления поведением запроса и передачи дополнительной информации от ответа обратно в приложение. Атрибуты также расширяемы, позволяя пользовательским реализациям передавать пользовательские значения.
В следующей таблице объясняются значения кодов атрибутов по умолчанию, соответствующие типы QVariant, значение по умолчанию, если атрибут отсутствует, и используется ли он в запросах или ответах.
| Константа | Значение | Описание |
|---|---|---|
QNetworkRequest::HttpStatusCodeAttribute |
0 |
Только для ответов, тип: QMetaType::Int (без значения по умолчанию) Указывает код HTTP-статуса, полученный от HTTP-сервера (например, 200, 304, 404, 401 и т. д.). Если соединение не было основано на HTTP, этот атрибут отсутствует. |
QNetworkRequest::HttpReasonPhraseAttribute |
1 |
Только для ответов, тип: QMetaType::QByteArray (без значения по умолчанию) Указывает фразу причины HTTP-статуса, полученную от HTTP-сервера (например, "Ok", "Found", "Not Found", "Access Denied" и т. д.). Это удобочитаемое представление кода состояния (см. выше). Если соединение не было основано на HTTP, этот атрибут отсутствует. |
QNetworkRequest::RedirectionTargetAttribute |
2 |
Только для ответов, тип: QMetaType::QUrl (без значения по умолчанию) Если присутствует, указывает, что сервер перенаправляет запрос на другой URL. Модуль доступа к сети по умолчанию следует за перенаправлениями, но если включён QNetworkRequest::ManualRedirectPolicy и перенаправление не обрабатывалось в redirected(), этот атрибут будет присутствовать. Возвращаемый URL может быть относительным. Используйте QUrl::resolved(), чтобы создать абсолютный URL. |
QNetworkRequest::ConnectionEncryptedAttribute |
3 |
Только для ответов, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, получены ли данные по защищённому (безопасном) соединению. |
QNetworkRequest::CacheLoadControlAttribute |
4 |
Только для запросов, тип: QMetaType::Int (значение по умолчанию: QNetworkRequest::PreferNetwork) Управляет доступом к кешу. Возможные значения — те, что перечислены в QNetworkRequest::CacheLoadControl. Обратите внимание, что реализация по умолчанию QNetworkAccessManager не поддерживает кеширование. Однако этот атрибут может использоваться некоторыми бэкендами для изменения своих запросов (например, для кеширования прокси). |
QNetworkRequest::CacheSaveControlAttribute |
5 |
Только для запросов, тип: QMetaType::Bool (значение по умолчанию: true) Управляет тем, следует ли сохранять полученные данные в кеше для последующего использования. Если значение равно false, полученные данные не будут автоматически кешироваться. Если true, данные могут быть кешированы, если они кешируемы (что кешируется, зависит от используемого протокола). |
QNetworkRequest::SourceIsFromCacheAttribute |
6 |
Только для ответов, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, получены ли данные из кеша или нет. |
QNetworkRequest::DoNotBufferUploadDataAttribute |
7 |
Только для запросов, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, разрешено ли коду QNetworkAccessManager буферизовать данные загрузки, например, при выполнении HTTP POST. При использовании этого флага с последовательными данными загрузки необходимо установить заголовок ContentLengthHeader. |
QNetworkRequest::HttpPipeliningAllowedAttribute |
8 |
Только для запросов, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, разрешено ли коду QNetworkAccessManager использовать HTTP-пипелинирование с этим запросом. |
QNetworkRequest::HttpPipeliningWasUsedAttribute |
9 |
Только для ответов, тип: QMetaType::Bool Указывает, использовалось ли HTTP-пипелинирование для получения этого ответа. |
QNetworkRequest::CustomVerbAttribute |
10 |
Только для запросов, тип: QMetaType::QByteArray Содержит значение пользовательского HTTP-глагола для отправки (предназначенного для использования других глаголов, кроме GET, POST, PUT и DELETE). Этот глагол устанавливается при вызове QNetworkAccessManager::sendCustomRequest(). |
QNetworkRequest::CookieLoadControlAttribute |
11 |
Только для запросов, тип: QMetaType::Int (значение по умолчанию: QNetworkRequest::Automatic) Указывает, следует ли отправлять заголовки 'Cookie' в запросе. Этот атрибут устанавливается в false Qt WebKit при создании кросс-доменного XMLHttpRequest, где withCredentials явно не был установлен в true JavaScript, создавшим запрос. См. здесь для получения дополнительной информации. (Это значение было добавлено в 4.7.) |
QNetworkRequest::CookieSaveControlAttribute |
13 |
Только для запросов, тип: QMetaType::Int (значение по умолчанию: QNetworkRequest::Automatic) Указывает, следует ли сохранять заголовки 'Cookie', полученные от сервера в ответ на запрос. Этот атрибут устанавливается в false Qt WebKit при создании кросс-доменного XMLHttpRequest, где withCredentials явно не был установлен в true JavaScript, создавшим запрос. См. здесь для получения дополнительной информации. (Это значение было добавлено в 4.7.) |
QNetworkRequest::AuthenticationReuseAttribute |
12 |
Только для запросов, тип: QMetaType::Int (значение по умолчанию: QNetworkRequest::Automatic) Указывает, следует ли использовать кешированные учетные данные авторизации в запросе, если они доступны. Если это установлено в QNetworkRequest::Manual, а механизм аутентификации — 'Basic' или 'Digest', Qt не будет отправлять HTTP-заголовок 'Authorization' с любыми кешированными учетными данными, которые могут быть у него для URL запроса. Этот атрибут устанавливается в QNetworkRequest::Manual Qt WebKit при создании кросс-доменного XMLHttpRequest, где withCredentials явно не был установлен в true JavaScript, создавшим запрос. См. здесь для получения дополнительной информации. (Это значение было добавлено в 4.7.) |
QNetworkRequest::BackgroundRequestAttribute |
17 |
Тип: QMetaType::Bool (значение по умолчанию: false) Указывает, что это передача в фоновом режиме, а не инициированная пользователем. В зависимости от платформы, передачи в фоновом режиме могут подчиняться различным правилам. |
QNetworkRequest::Http2AllowedAttribute |
19 |
Только для запросов, тип: QMetaType::Bool (значение по умолчанию: true) Указывает, разрешено ли коду QNetworkAccessManager использовать HTTP/2 с этим запросом. Это относится к запросам SSL или 'cleartext' HTTP/2. |
QNetworkRequest::Http2WasUsedAttribute |
20 |
Только для ответов, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, использовался ли HTTP/2 для получения этого ответа. (Это значение было добавлено в 5.9.) |
QNetworkRequest::EmitAllUploadProgressSignalsAttribute |
18 |
Только для запросов, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, должны ли быть вызваны все сигналы загрузки. По умолчанию сигнал uploadProgress вызывается только через 100 миллисекунд. (Это значение было добавлено в 5.5.) |
QNetworkRequest::OriginalContentLengthAttribute |
21 |
Только для ответов, тип QMetaType::Int Содержит исходный атрибут content-length до его отмены и удаления из заголовка, когда данные сжимаются, а запрос помечен для автоматической распаковки. (Это значение было добавлено в 5.9.) |
QNetworkRequest::RedirectPolicyAttribute |
22 |
Только для запросов, тип: QMetaType::Int, должно быть одним из значений QNetworkRequest::RedirectPolicy (значение по умолчанию: NoLessSafeRedirectPolicy). (Это значение было добавлено в 5.9.) |
QNetworkRequest::Http2DirectAttribute |
23 |
Только для запросов, тип: QMetaType::Bool (значение по умолчанию: false) Если установлено, этот атрибут принудит QNetworkAccessManager использовать протокол HTTP/2 без первоначального согласования протокола HTTP/2. Использование этого атрибута подразумевает предварительное знание того, что конкретный сервер поддерживает HTTP/2. Атрибут работает с SSL или 'cleartext' HTTP/2. Если выяснится, что сервер не поддерживает HTTP/2, когда был указан прямой HTTP/2, QNetworkAccessManager откажется, не пытаясь перейти обратно к HTTP/1.1. Если оба атрибута Http2AllowedAttribute и Http2DirectAttribute установлены, Http2DirectAttribute имеет приоритет. (Это значение было добавлено в 5.11.) |
QNetworkRequest::AutoDeleteReplyOnFinishAttribute |
25 |
Только для запросов, тип: QMetaType::Bool (значение по умолчанию: false) Если установлено, этот атрибут заставит QNetworkAccessManager удалить QNetworkReply после вызова "finished". (Это значение было добавлено в 5.14.) |
QNetworkRequest::User |
1000 |
Специальный тип. Дополнительная информация может быть передана в QVariants с типами от User до UserMax. Реализация Network Access по умолчанию проигнорирует любые атрибуты запроса в этом диапазоне и не будет генерировать атрибуты в этом диапазоне в ответах. Этот диапазон зарезервирован для расширений QNetworkAccessManager. |
QNetworkRequest::UserMax |
32767 |
Специальный тип. См. User. |
enum QNetworkRequest::CacheLoadControl
Управляет механизмом кэширования QNetworkAccessManager.
| Постоянная | Значение | Описание |
|---|---|---|
QNetworkRequest::AlwaysNetwork |
0 |
всегда загружать из сети и не проверять, есть ли в кэше подходящая запись (аналогично функции "Перезагрузка" в браузерах); кроме того, заставить промежуточные кэши повторно валидироваться. |
QNetworkRequest::PreferNetwork |
1 |
Значение по умолчанию; загружать из сети, если кэшированная запись старше сетевой. Это никогда не вернёт устаревшие данные из кэша, но перепроверит ресурсы, которые стали устаревшими. |
QNetworkRequest::PreferCache |
2 |
Загружать из кэша, если он доступен, иначе — из сети. Обратите внимание, что это может вернуть, возможно, устаревшие (но не просроченные) элементы из кэша. |
QNetworkRequest::AlwaysCache |
3 |
Загружать только из кэша, выводить ошибку, если элемент не был кэширован (например, режим офлайн). |
enum QNetworkRequest::KnownHeaders
Список известных типов заголовков, которые анализирует QNetworkRequest. Каждый известный заголовок также представлен в сыром виде со своим полным именем HTTP.
| Постоянная | Значение | Описание |
|---|---|---|
QNetworkRequest::ContentDispositionHeader |
6 |
Соответствует HTTP-заголовку Content-Disposition и содержит строку с типом расположения (например, вложение) и параметром (например, имя файла). |
QNetworkRequest::ContentTypeHeader |
0 |
Соответствует HTTP-заголовку Content-Type и содержит строку со средством (MIME-типом) и дополнительными данными (например, кодировка). |
QNetworkRequest::ContentLengthHeader |
1 |
Соответствует HTTP-заголовку Content-Length и содержит длину передаваемых данных в байтах. |
QNetworkRequest::LocationHeader |
2 |
Соответствует HTTP-заголовку Location и содержит URL, представляющий фактическое расположение данных, включая URL назначения в случае перенаправлений. |
QNetworkRequest::LastModifiedHeader |
3 |
Соответствует HTTP-заголовку Last-Modified и содержит QDateTime, представляющий последнюю дату изменения содержимого. |
QNetworkRequest::IfModifiedSinceHeader |
9 |
Соответствует HTTP-заголовку If-Modified-Since и содержит QDateTime. Обычно добавляется к QNetworkRequest. Сервер должен отправить ответ 304 (Not Modified), если ресурс не изменился с этого момента. |
QNetworkRequest::ETagHeader |
10 |
Соответствует HTTP-заголовку ETag и содержит QString, представляющий последнее состояние изменения содержимого. |
QNetworkRequest::IfMatchHeader |
11 |
Соответствует HTTP-заголовку If-Match и содержит QStringList. Обычно добавляется к QNetworkRequest. Сервер должен отправить ответ 412 (Precondition Failed), если ресурс не соответствует. |
QNetworkRequest::IfNoneMatchHeader |
12 |
Соответствует HTTP-заголовку If-None-Match и содержит QStringList. Обычно добавляется к QNetworkRequest. Сервер должен отправить ответ 304 (Not Modified), если ресурс соответствует. |
QNetworkRequest::CookieHeader |
4 |
Соответствует HTTP-заголовку Cookie и содержит QList<QNetworkCookie>, представляющий cookie, которые необходимо отправить обратно серверу. |
QNetworkRequest::SetCookieHeader |
5 |
Соответствует HTTP-заголовку Set-Cookie и содержит QList<QNetworkCookie>, представляющий cookie, отправленные сервером для хранения локально. |
QNetworkRequest::UserAgentHeader |
7 |
Заголовок User-Agent, отправляемый HTTP-клиентами. |
QNetworkRequest::ServerHeader |
8 |
Заголовок Server, полученный HTTP-клиентами. |
См. также header(), setHeader(), rawHeader(), и setRawHeader().
enum QNetworkRequest::LoadControl
Указывает, была ли какая-либо часть механизма загрузки запроса переопределена вручную, например, Qt WebKit.
| Постоянная | Значение | Описание |
|---|---|---|
QNetworkRequest::Automatic |
0 |
Значение по умолчанию: указывает стандартное поведение. |
QNetworkRequest::Manual |
1 |
Указывает, что поведение было переопределено вручную. |
enum QNetworkRequest::Priority
Этот перечисление содержит возможные приоритеты сетевых запросов.
| Постоянная | Значение | Описание |
|---|---|---|
QNetworkRequest::HighPriority |
1 |
Высокий приоритет |
QNetworkRequest::NormalPriority |
3 |
Нормальный приоритет |
QNetworkRequest::LowPriority |
5 |
Низкий приоритет |
[since 5.9] enum QNetworkRequest::RedirectPolicy
Указывает, должна ли сетевая API автоматически следовать ответу HTTP-перенаправления или нет.
| Постоянная | Значение | Описание |
|---|---|---|
QNetworkRequest::ManualRedirectPolicy |
0 |
Не выполнять перенаправления. |
QNetworkRequest::NoLessSafeRedirectPolicy |
1 |
Значение по умолчанию: разрешены только перенаправления "http"->"http", "http" -> "https" или "https" -> "https". |
QNetworkRequest::SameOriginRedirectPolicy |
2 |
Требуется тот же протокол, хост и порт. Обратите внимание, что http://example.com и http://example.com:80 не пройдут с этой политикой (неявные/явные порты считаются несовпадением). |
QNetworkRequest::UserVerifiedRedirectPolicy |
3 |
Клиент решает, следует ли выполнять каждое перенаправление, обрабатывая сигнал redirected(), излучая redirectAllowed() в объекте QNetworkReply, чтобы разрешить перенаправление, или прерывая/завершая его, чтобы отклонить перенаправление. Это можно использовать, например, чтобы спросить пользователя, следует ли принимать перенаправление, или чтобы принять решение на основе какой-либо конфигурации приложения. |
Это перечисление было введено или изменено в Qt 5.9.
[since 5.15] enum QNetworkRequest::TransferTimeoutConstant
Константа, которая может быть использована для включения таймаутов передачи с предварительно заданным значением.
| Постоянная | Значение | Описание |
|---|---|---|
QNetworkRequest::DefaultTransferTimeoutConstant |
30000 |
Таймаут передачи в миллисекундах. Используется, если setTimeout() вызывается без аргумента. |
Это перечисление было введено или изменено в Qt 5.15.
Документация по функциям-членам
QNetworkRequest::QNetworkRequest(const QNetworkRequest &other)
Создаёт копию other.
QNetworkRequest::QNetworkRequest(const QUrl &url)
Создаёт объект QNetworkRequest с url в качестве URL, который необходимо запросить.
QNetworkRequest::QNetworkRequest()
Создаёт объект QNetworkRequest без URL, который необходимо запросить. Используйте setUrl() для его задания.
QNetworkRequest &QNetworkRequest::operator=(const QNetworkRequest &other)
Создаёт копию other
QNetworkRequest::~QNetworkRequest()
Удаляет объект QNetworkRequest.
QVariant QNetworkRequest::attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const
Возвращает атрибут, связанный с кодом code. Если атрибут не задан, возвращает defaultValue.
Примечание: Эта функция не применяет значения по умолчанию, перечисленные в QNetworkRequest::Attribute.
См. также setAttribute() и QNetworkRequest::Attribute.
[since 6.2] qint64 QNetworkRequest::decompressedSafetyCheckThreshold() const
Возвращает порог проверки на «бомбы» сжатия.
Если декомпрессированный размер ответа меньше этого порога, Qt просто его декомпримирует без дальнейшей проверки.
Эта функция была добавлена в Qt 6.2.
См. также setDecompressedSafetyCheckThreshold().
bool QNetworkRequest::hasRawHeader(const QByteArray &headerName) const
Возвращает true, если сырой заголовок headerName присутствует в этом сетевом запросе.
См. также rawHeader() и setRawHeader().
QVariant QNetworkRequest::header(QNetworkRequest::KnownHeaders header) const
Возвращает значение известного сетевого заголовка header, если оно присутствует в запросе. Если заголовок отсутствует, возвращает QVariant() (т.е. недействительный вариант).
См. также KnownHeaders, rawHeader() и setHeader().
[since 5.14] QHttp2Configuration QNetworkRequest::http2Configuration() const
Возвращает текущие параметры, которые QNetworkAccessManager использует для этого запроса и его базового HTTP/2 соединения. Это либо конфигурация, заданная приложением, либо конфигурация по умолчанию.
Значения по умолчанию, используемые QNetworkAccessManager:
- Размер окна для управления потоком на уровне соединения — 2147483647 байт
- Размер окна для управления потоком на уровне потока — 21474836 байт
- Максимальный размер кадра — 16384
По умолчанию, серверное push отключено, сжатие Хаффмана и индексация строк включены.
Эта функция была добавлена в Qt 5.14.
См. также setHttp2Configuration.
[since 5.6] int QNetworkRequest::maximumRedirectsAllowed() const
Возвращает максимальное количество разрешенных перенаправлений для этого запроса.
Эта функция была добавлена в Qt 5.6.
См. также setMaximumRedirectsAllowed().
QObject *QNetworkRequest::originatingObject() const
Возвращает ссылку на объект, который инициировал этот сетевой запрос; возвращает nullptr, если не задано или объект был уничтожен.
См. также setOriginatingObject().
[since 5.13] QString QNetworkRequest::peerVerifyName() const
Возвращает имя хоста, установленное для проверки сертификата, как задано в setPeerVerifyName. По умолчанию возвращает пустую строку.
Эта функция была добавлена в Qt 5.13.
См. также setPeerVerifyName.
QNetworkRequest::Priority QNetworkRequest::priority() const
Возвращает приоритет этого запроса.
См. также setPriority().
QByteArray QNetworkRequest::rawHeader(const QByteArray &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 для проверки «бомб» сжатия.
Некоторые поддерживаемые алгоритмы сжатия могут в небольшом сжатом файле закодировать чрезвычайно большой декомпрессированный файл. Это возможно только если декомпрессированное содержимое чрезвычайно однообразно, что редко бывает для реальных файлов, передаваемых добросовестно: файлы, использующие такие безумно высокие коэффициенты сжатия, обычно являются payload атаками на переполнение буфера или атаками отказа в обслуживании (путем израсходования слишком много памяти). Следовательно, файлы, которые декомпримируются до больших размеров, особенно из крошечных сжатых форм, лучше всего отклонять как потенциально вредоносные.
Если декомпрессированный размер ответа больше этого порога (по умолчанию 10 МБ), Qt проверит коэффициент сжатия: если он слишком велик (40:1 для GZip и Deflate или 100:1 для Brotli и ZStandard), ответ будет обработан как ошибка. Установка порога в -1 отключает эту проверку.
Эта функция была добавлена в Qt 6.2.
См. также decompressedSafetyCheckThreshold().
void QNetworkRequest::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)
Устанавливает значение известного заголовка header равным value, перезаписывая все ранее установленные заголовки. Эта операция также устанавливает эквивалентный сырой HTTP заголовок.
См. также KnownHeaders, setRawHeader() и header().
[since 5.14] void QNetworkRequest::setHttp2Configuration(const QHttp2Configuration &configuration)
Устанавливает параметры HTTP/2 запроса из configuration.
Примечание: Конфигурация должна быть установлена до отправки запроса.
Примечание: HTTP/2 мультиплексирует несколько потоков в одном HTTP/2 соединении. Это означает, что QNetworkAccessManager будет использовать конфигурацию, найденную в первом запросе из серии запросов, отправленных на тот же хост.
Эта функция была добавлена в Qt 5.14.
См. также http2Configuration, QNetworkAccessManager и QHttp2Configuration.
[since 5.6] void QNetworkRequest::setMaximumRedirectsAllowed(int maxRedirectsAllowed)
Устанавливает максимальное количество разрешенных перенаправлений для этого запроса равным maxRedirectsAllowed.
Эта функция была добавлена в Qt 5.6.
См. также maximumRedirectsAllowed().
void QNetworkRequest::setOriginatingObject(QObject *object)
Позволяет задать ссылку на объект, инициализирующий запрос.
Например, Qt WebKit устанавливает исходный объект в QWebFrame, который инициировал запрос.
См. также originatingObject().
[since 5.13] void QNetworkRequest::setPeerVerifyName(const QString &peerName)
Устанавливает peerName в качестве имени хоста для проверки сертификата вместо имени, используемого для TCP-соединения.
Эта функция была добавлена в Qt 5.13.
См. также peerVerifyName.
void QNetworkRequest::setPriority(QNetworkRequest::Priority priority)
Установите приоритет этого запроса в priority.
Примечание: priority — это лишь подсказка для менеджера сетевого доступа. Он может её использовать, а может и не использовать. В настоящее время она используется для HTTP, чтобы определить, какой запрос следует отправить серверу первым.
См. также 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, полученного из распарсенной даты.
Примечание: Установка одного и того же заголовка дважды перезаписывает предыдущее значение. Чтобы добиться поведения нескольких HTTP-заголовков с одинаковым именем, необходимо конкатенировать оба значения, разделяя их запятой (",") и установить один единственный "сырой" заголовок.
См. также KnownHeaders, setHeader(), hasRawHeader(), и rawHeader().
void QNetworkRequest::setSslConfiguration(const QSslConfiguration &config)
Устанавливает конфигурацию SSL для этого сетевого запроса на config. Устанавливаются значения, такие как закрытый ключ, локальный сертификат, протокол SSL (SSLv2, SSLv3, TLSv1.0, где применимо), сертификаты CA и шифры, которые разрешено использовать SSL-бекенду.
См. также sslConfiguration() и QSslConfiguration::defaultConfiguration().
[since 5.15] void QNetworkRequest::setTransferTimeout(int timeout = DefaultTransferTimeoutConstant)
Устанавливает timeout как таймаут передачи в миллисекундах.
Передачи прерываются, если перед истечением таймаута не передано ни одного байта. Ноль означает, что таймер не установлен. Если аргумент не указан, таймаут равен QNetworkRequest::DefaultTransferTimeoutConstant. Если эта функция не вызывается, таймаут отключен и имеет значение ноль.
Эта функция была добавлена в Qt 5.15.
См. также transferTimeout.
void QNetworkRequest::setUrl(const QUrl &url)
Устанавливает URL-адрес, к которому относится этот сетевой запрос, на url.
См. также url().
QSslConfiguration QNetworkRequest::sslConfiguration() const
Возвращает конфигурацию SSL этого сетевого запроса. По умолчанию она такая же, как QSslConfiguration::defaultConfiguration().
См. также setSslConfiguration() и QSslConfiguration::defaultConfiguration().
[since 5.0] void QNetworkRequest::swap(QNetworkRequest &other)
Меняет местами этот сетевой запрос и other. Эта функция очень быстрая и никогда не завершается ошибкой.
Эта функция была добавлена в Qt 5.0.
[since 5.15] int QNetworkRequest::transferTimeout() const
Возвращает таймаут передачи в миллисекундах.
Этот таймаут равен нулю, если setTransferTimeout не вызывалась, что означает, что таймаут не используется.
Эта функция была добавлена в Qt 5.15.
См. также setTransferTimeout.
QUrl QNetworkRequest::url() const
Возвращает URL-адрес, к которому относится этот сетевой запрос.
См. также setUrl().
bool QNetworkRequest::operator!=(const QNetworkRequest &other) const
Возвращает false если этот объект не равен other.
См. также operator==().
bool QNetworkRequest::operator==(const QNetworkRequest &other) const
Возвращает true если этот объект равен other (т.е. если у них одинаковый URL, одинаковые заголовки и одинаковые настройки метаданных).
См. также operator!=().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qnetworkrequest.html
