Класс QNetworkRequest
Класс QNetworkRequest содержит запрос, который будет отправлен с помощью QNetworkAccessManager. Подробнее...
| Заголовок: | #include <QNetworkRequest> |
| qmake: | QT += network |
| С версии: | Qt 4.4 |
Этот класс был введен в Qt 4.4.
Открытые типы
| enum | Attribute { HttpStatusCodeAttribute, HttpReasonPhraseAttribute, RedirectionTargetAttribute, ConnectionEncryptedAttribute, CacheLoadControlAttribute, …, UserMax } |
| enum | CacheLoadControl { AlwaysNetwork, PreferNetwork, PreferCache, AlwaysCache } |
| enum | KnownHeaders { ContentDispositionHeader, ContentTypeHeader, ContentLengthHeader, LocationHeader, LastModifiedHeader, …, ServerHeader } |
| enum | LoadControl { Automatic, Manual } |
| enum | Priority { HighPriority, NormalPriority, LowPriority } |
| enum | RedirectPolicy { ManualRedirectPolicy, NoLessSafeRedirectPolicy, SameOriginRedirectPolicy, UserVerifiedRedirectPolicy } |
| enum | 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 |
| 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 | 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.
Документация по типам членов
enum 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. API сетевого доступа по умолчанию не следует перенаправлениям: приложение может определить, разрешено ли указанное перенаправление в соответствии с его политикой безопасности, или оно может установить QNetworkRequest::FollowRedirectsAttribute в true (в этом случае перенаправление будет выполнено, и этот атрибут не будет присутствовать в ответе). Возвращаемый 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 не будет отправлять заголовок 'Authorization' HTTP с любыми кэшированными учетными данными, которые могут быть для URL запроса. Этот атрибут устанавливается в QNetworkRequest::Manual Qt WebKit при создании кросс-доменного XMLHttpRequest, где withCredentials не был явно установлен в true JavaScript, создавшим запрос. См. здесь для получения дополнительной информации. (Это значение было добавлено в 4.7.) |
QNetworkRequest::BackgroundRequestAttribute |
17 |
Тип: QMetaType::Bool (значение по умолчанию: false) Указывает, что это передача в фоновом режиме, а не инициированная пользователем. В зависимости от платформы, фоновые передачи могут быть связаны с разными политиками. Свойство QNetworkSession ConnectInBackground будет установлено в соответствии с этим атрибутом. |
QNetworkRequest::SpdyAllowedAttribute |
18 |
Только запросы, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, разрешено ли коду QNetworkAccessManager использовать SPDY с этим запросом. Это относится только к запросам SSL и зависит от поддержки SPDY сервером. Устарело, используйте Http2 вместо Spdy. |
QNetworkRequest::SpdyWasUsedAttribute |
19 |
Только ответы, тип: QMetaType::Bool Указывает, использовалось ли SPDY для получения этого ответа. Устарело, используйте Http2 вместо Spdy. |
QNetworkRequest::Http2AllowedAttribute |
22 |
Только запросы, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, разрешено ли коду QNetworkAccessManager использовать HTTP/2 с этим запросом. Это относится к запросам SSL или "cleartext" HTTP/2. |
QNetworkRequest::Http2WasUsedAttribute |
23 |
Только ответы, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, использовалось ли HTTP/2 для получения этого ответа. (Это значение было добавлено в 5.9.) |
QNetworkRequest::HTTP2AllowedAttribute |
Http2AllowedAttribute |
Устаревший псевдоним для Http2AllowedAttribute. |
QNetworkRequest::HTTP2WasUsedAttribute |
23 |
Устаревший псевдоним для Http2WasUsedAttribute. |
QNetworkRequest::EmitAllUploadProgressSignalsAttribute |
BackgroundRequestAttribute + 3 |
Только запросы, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, нужно ли отправлять все сигналы загрузки. По умолчанию сигнал uploadProgress отправляется только через интервалы в 100 миллисекунд. (Это значение было добавлено в 5.5.) |
QNetworkRequest::FollowRedirectsAttribute |
21 |
Только запросы, тип: QMetaType::Bool (значение по умолчанию: false) Указывает, следует ли API сетевого доступа автоматически следовать ответу HTTP-перенаправления или нет. В настоящее время не разрешены перенаправления, которые небезопасны, то есть перенаправление с протокола "https" на протокол "http". (Это значение было добавлено в 5.6.) |
QNetworkRequest::OriginalContentLengthAttribute |
24 |
Только ответы, тип QMetaType::Int Содержит исходный атрибут content-length перед его аннулированием и удалением из заголовка, когда данные сжимаются, а запрос помечен для автоматического разархивирования. (Это значение было добавлено в 5.9.) |
QNetworkRequest::RedirectPolicyAttribute |
25 |
Только для запросов, тип: QMetaType::Int, должен быть одним из значений QNetworkRequest::RedirectPolicy (по умолчанию: ManualRedirectPolicy). Этот атрибут устарел атрибут FollowRedirectsAttribute. (Это значение было введено в 5.9.) |
QNetworkRequest::Http2DirectAttribute |
26 |
Только для запросов, тип: QMetaType::Bool (по умолчанию: false). Если установлено, этот атрибут принудительно заставит QNetworkAccessManager использовать протокол HTTP/2 без предварительного согласования протокола HTTP/2. Использование этого атрибута предполагает предварительные знания о том, что конкретный сервер поддерживает HTTP/2. Атрибут работает с SSL или 'cleartext' HTTP/2. Если сервер окажется не поддерживает HTTP/2, когда был указан HTTP/2 direct, QNetworkAccessManager откажется, не пытаясь перейти к HTTP/1.1. Если оба атрибута Http2AllowedAttribute и Http2DirectAttribute установлены, Http2DirectAttribute имеет приоритет. (Это значение было введено в 5.11.) |
QNetworkRequest::AutoDeleteReplyOnFinishAttribute |
28 |
Только для запросов, тип: QMetaType::Bool (по умолчанию: false). Если установлено, этот атрибут заставит QNetworkAccessManager удалить QNetworkReply после того, как был испущен сигнал "finished". (Это значение было введено в 5.14.) |
QNetworkRequest::User |
1000 |
Специальный тип. Дополнительная информация может быть передана в QVariants с типами, начиная от User до UserMax. По умолчанию, реализация Network Access игнорирует атрибуты запроса в этом диапазоне и не генерирует атрибуты в этом диапазоне в ответах. Диапазон зарезервирован для расширений QNetworkAccessManager. |
QNetworkRequest::UserMax |
32767 |
Специальный тип. См. User. |
Этот перечисление был введен или изменен в Qt 4.7.
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>, представляющую куки, которые нужно отправить обратно на сервер. |
QNetworkRequest::SetCookieHeader |
5 |
Соответствует заголовку HTTP Set-Cookie и содержит QList<QNetworkCookie>, представляющую куки, отправленные сервером для локального хранения. |
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 |
указывает, что поведение было переопределено вручную. |
Этот перечисление был введен или изменен в Qt 4.7.
enum QNetworkRequest::Priority
В этом перечислении перечислены возможные приоритеты сетевых запросов.
| Постоянная | Значение | Описание |
|---|---|---|
QNetworkRequest::HighPriority |
1 |
Высокий приоритет |
QNetworkRequest::NormalPriority |
3 |
Нормальный приоритет |
QNetworkRequest::LowPriority |
5 |
Низкий приоритет |
Этот перечисление был введен или изменен в Qt 4.7.
enum QNetworkRequest::RedirectPolicy
Указывает, должен ли API доступа к сети автоматически следовать ответу HTTP о перенаправлении или нет.
| Постоянная | Значение | Описание |
|---|---|---|
QNetworkRequest::ManualRedirectPolicy |
0 |
Значение по умолчанию: не следовать перенаправлениям. |
QNetworkRequest::NoLessSafeRedirectPolicy |
1 |
Разрешены только перенаправления "http" -> "http", "http" -> "https" или "https" -> "https". Эквивалентно установке старого атрибута FollowRedirectsAttribute в значение true. |
QNetworkRequest::SameOriginRedirectPolicy |
2 |
Требуется одинаковый протокол, хост и порт. Обратите внимание, что http://example.com и http://example.com:80 не пройдут проверку с этим правилом (явные и неявные порты считаются несовместимыми). |
QNetworkRequest::UserVerifiedRedirectPolicy |
3 |
Клиент решает, следовать ли каждому перенаправлению, обрабатывая сигнал redirected() и вызывая redirectAllowed() на объекте QNetworkReply, чтобы разрешить перенаправление, или прерывая/завершая его, чтобы отклонить перенаправление. Это может быть использовано, например, для запроса у пользователя о согласии на перенаправление или для принятия решения на основе определённой конфигурации приложения. |
Этот перечисление был введён или изменён в Qt 5.9.
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.
bool QNetworkRequest::hasRawHeader(const QByteArray &headerName) const
Возвращает значение true, если сырой заголовок headerName присутствует в этом сетевом запросе.
См. также rawHeader() и setRawHeader().
QVariant QNetworkRequest::header(QNetworkRequest::KnownHeaders header) const
Возвращает значение известного сетевого заголовка header, если оно присутствует в этом запросе. Если оно отсутствует, возвращает QVariant() (т.е., некорректное значение).
См. также KnownHeaders, rawHeader() и setHeader().
QHttp2Configuration QNetworkRequest::http2Configuration() const
Возвращает текущие параметры, которые QNetworkAccessManager использует для этого запроса и его базового соединения HTTP/2. Это либо конфигурация, ранее заданная приложением, либо конфигурация по умолчанию.
Значения по умолчанию, которые использует QNetworkAccessManager:
- Размер окна для управления потоком на уровне соединения составляет 2147483647 байтов.
- Размер окна для управления потоком на уровне потока составляет 21474836 байтов.
- Максимальный размер фрейма составляет 16384.
По умолчанию серверное принудительное подключение отключено, сжатие Хаффмана и индексация строк включены.
Эта функция была введена в Qt 5.14.
См. также setHttp2Configuration.
int QNetworkRequest::maximumRedirectsAllowed() const
Возвращает максимальное количество разрешённых перенаправлений для этого запроса.
Эта функция была введена в Qt 5.6.
См. также setMaximumRedirectsAllowed().
QObject *QNetworkRequest::originatingObject() const
Возвращает ссылку на объект, который инициировал этот сетевой запрос; возвращает nullptr, если не задан или объект был удалён.
Эта функция была введена в Qt 4.6.
См. также setOriginatingObject().
QString QNetworkRequest::peerVerifyName() const
Возвращает имя хоста, установленное для проверки сертификата, как задано в setPeerVerifyName. По умолчанию возвращается пустая строка.
Эта функция была введена в Qt 5.13.
См. также setPeerVerifyName.
QNetworkRequest::Priority QNetworkRequest::priority() const
Возвращает приоритет этого запроса.
Эта функция была введена в Qt 4.7.
См. также 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.
void QNetworkRequest::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)
Устанавливает значение известного заголовка header в value, перезаписывая любые ранее установленные заголовки. Эта операция также устанавливает эквивалентный сырой HTTP-заголовок.
См. также KnownHeaders, setRawHeader() и header().
void QNetworkRequest::setHttp2Configuration(const QHttp2Configuration &configuration)
Устанавливает параметры HTTP/2 запроса из configuration.
Примечание: Конфигурация должна быть установлена до отправки запроса.
Примечание: HTTP/2 мультиплексирует несколько потоков в одном соединении HTTP/2. Это означает, что QNetworkAccessManager будет использовать конфигурацию, найденную в первом запросе из ряда запросов, отправленных тому же хосту.
Эта функция была введена в Qt 5.14.
См. также http2Configuration, QNetworkAccessManager и QHttp2Configuration.
void QNetworkRequest::setMaximumRedirectsAllowed(int maxRedirectsAllowed)
Устанавливает максимальное количество перенаправлений, разрешённых для этого запроса, в значение maxRedirectsAllowed.
Эта функция была добавлена в Qt 5.6.
См. также maximumRedirectsAllowed().
void QNetworkRequest::setOriginatingObject(QObject *object)
Разрешает установить ссылку на объект, инициировавший запрос.
Например, Qt WebKit устанавливает исходный объект в QWebFrame, который инициировал запрос.
Эта функция была добавлена в Qt 4.6.
См. также originatingObject().
void QNetworkRequest::setPeerVerifyName(const QString &peerName)
Устанавливает peerName в качестве имени хоста для проверки сертификата вместо имени, используемого для TCP-соединения.
Эта функция была добавлена в Qt 5.13.
См. также peerVerifyName.
void QNetworkRequest::setPriority(QNetworkRequest::Priority priority)
Устанавливает приоритет этого запроса в значение priority.
Примечание: Приоритет priority — лишь подсказка для менеджера сетевого доступа. Он может использовать его или нет. В настоящее время он используется для HTTP, чтобы определить, какой запрос следует отправить серверу первым.
Эта функция была добавлена в Qt 4.7.
См. также 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().
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().
void QNetworkRequest::swap(QNetworkRequest &other)
Меняет местами этот сетевой запрос с other. Эта функция очень быстрая и никогда не терпит неудач.
Эта функция была добавлена в Qt 5.0.
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-5.15/qnetworkrequest.html
