QNetworkRequest Class
QNetworkRequest クラスは、QNetworkAccessManager で送信するリクエストを保持します。さらに...
| ヘッダー | #include <QNetworkRequest> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Network)target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake： | QT += network |
- 継承メンバを含む全メンバのリスト
- QNetworkRequest はNetwork Programming APIおよびImplicitly Shared Classes に含まれています。
パブリック型
| 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() | |
| QNetworkRequest(const QUrl &url) | |
| QNetworkRequest(const QNetworkRequest &other) | |
| ~QNetworkRequest() | |
| QVariant | attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const |
(since 6.2) qint64 | decompressedSafetyCheckThreshold() const |
| bool | hasRawHeader(QAnyStringView headerName) const |
| QVariant | header(QNetworkRequest::KnownHeaders header) const |
(since 6.8) QHttpHeaders | headers() const |
(since 6.5) QHttp1Configuration | http1Configuration() const |
| QHttp2Configuration | http2Configuration() const |
| int | maximumRedirectsAllowed() const |
| QObject * | originatingObject() const |
| QString | peerVerifyName() const |
| QNetworkRequest::Priority | priority() const |
| QByteArray | rawHeader(QAnyStringView headerName) const |
| QList<QByteArray> | rawHeaderList() const |
| void | setAttribute(QNetworkRequest::Attribute code, const QVariant &value) |
(since 6.2) void | setDecompressedSafetyCheckThreshold(qint64 threshold) |
| void | setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value) |
(since 6.8) void | setHeaders(QHttpHeaders &&newHeaders) |
(since 6.8) void | setHeaders(const QHttpHeaders &newHeaders) |
(since 6.5) void | setHttp1Configuration(const QHttp1Configuration &configuration) |
| 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) |
(since 6.7) void | setTransferTimeout(std::chrono::milliseconds duration = DefaultTransferTimeout) |
| void | setUrl(const QUrl &url) |
| QSslConfiguration | sslConfiguration() const |
| void | swap(QNetworkRequest &other) |
| int | transferTimeout() const |
(since 6.7) std::chrono::milliseconds | transferTimeoutAsDuration() const |
| QUrl | url() const |
| bool | operator!=(const QNetworkRequest &other) const |
| QNetworkRequest & | operator=(const QNetworkRequest &other) |
| bool | operator==(const QNetworkRequest &other) const |
静的パブリック・メンバ
| const std::chrono::std::chrono::milliseconds | DefaultTransferTimeout |
詳細説明
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 | Replies only, type:QMetaType::QByteArray (no default) HTTP サーバーから受け取った HTTP 理由フレーズを示します (例えば "Ok", "Found", "Not Found", "Access Denied" など)。接続が HTTP ベースでない場合、この属性は存在しません。注意:HTTP/2 を使用している場合、理由フレーズは使用されません。 |
QNetworkRequest::RedirectionTargetAttribute | 2 | reply only, type:QMetaType::QUrl (no default) 存在する場合、サーバーがリクエストを別の URL にリダイレクトしていることを示します。Network Access API は、QNetworkRequest::ManualRedirectPolicy が使われない限り、デフォルトでリダイレクトに従います。さらに、QNetworkRequest::UserVerifiedRedirectPolicy が使用されている場合、リダイレクトに従わなかった場合はこの属性が設定されます。返されるURLは相対URLかもしれません。絶対URLを作成するには、QUrl::resolved （）を使用してください。 |
QNetworkRequest::ConnectionEncryptedAttribute | 3 | Replies only, type:QMetaType::Bool (default: false) データが暗号化された（安全な）接続を通して取得されたかどうかを示します。 |
QNetworkRequest::CacheLoadControlAttribute | 4 | Requests only, type:QMetaType::Int (default:QNetworkRequest::PreferNetwork) キャッシュへのアクセス方法を制御します。指定可能な値はQNetworkRequest::CacheLoadControl の値です。 デフォルトのQNetworkAccessManager 実装はキャッシュに対応していないことに注意してください。しかし、この属性は特定のバックエンドがリクエストを修正するために 使用されるかもしれません(例えば、キャッシュプロキシなど)。 |
QNetworkRequest::CacheSaveControlAttribute | 5 | Requests only, type:QMetaType::Bool (default: true) 取得したデータを将来の使用のためにキャッシュに保存するかどうかを制御します。値が false の場合、取得したデータは自動的にキャッシュされません。trueの場合、キャッシュ可能なデータであればキャッシュされます（何がキャッシュ可能かは使用するプロトコルに依存します）。 |
QNetworkRequest::SourceIsFromCacheAttribute | 6 | Replies only, type:QMetaType::Bool (default: false) データがキャッシュから取得されたかどうかを示す。 |
QNetworkRequest::DoNotBufferUploadDataAttribute | 7 | Requests only, type:QMetaType::Bool (default: false) HTTP POST のときなど、QNetworkAccessManager コードがアップロードデータをバッファリングすることを許可するかどうかを示します。シーケンシャルなアップロードデータでこのフラグを使用する場合、ContentLengthHeader ヘッダが設定されていなければなりません。 |
QNetworkRequest::HttpPipeliningAllowedAttribute | 8 | Requests only, type:QMetaType::Bool (default: false)QNetworkAccessManager コードがこのリクエストでHTTPパイプラインの使用を許可されているかどうかを示す。 |
QNetworkRequest::HttpPipeliningWasUsedAttribute | 9 | 返信のみ、タイプ： QMetaType::Bool このリプライの受信に HTTP パイプラインが使われたかどうかを示します。 |
QNetworkRequest::CustomVerbAttribute | 10 | リクエストのみ、タイプ： QMetaType::QByteArray 送信するカスタムHTTP動詞の値を保持する(GET、POST、PUT、DELETE以外の動詞を使用するためのもの)。この動詞は、QNetworkAccessManager::sendCustomRequest()を呼び出すときに設定される。 |
QNetworkRequest::CookieLoadControlAttribute | 11 | Requests only, type:QMetaType::Int (default:QNetworkRequest::Automatic) リクエストで「Cookie」ヘッダーを送るかどうかを示す。この属性は、リクエストを作成した Javascript によって withCredentials が明示的に true に設定されていないクロスオリジン XMLHttpRequest を作成するときに、Qt WebKit によって false に設定されます。詳細はこちらを参照してください。(この値は 4.7 で導入されました)。 |
QNetworkRequest::CookieSaveControlAttribute | 13 | Requests only, type:QMetaType::Int (default:QNetworkRequest::Automatic) リクエストに対する返信でサーバから受け取った 'Cookie' ヘッダを保存するかどうかを示します。この属性は、リクエストを作成した Javascript によって withCredentials が明示的に true に設定されていないクロスオリジン XMLHttpRequest を作成するときに、Qt WebKit によって false に設定されます。詳細はこちらを参照してください。(この値は 4.7 で導入されました)。 |
QNetworkRequest::AuthenticationReuseAttribute | 12 | Requests only, type:QMetaType::Int (default:QNetworkRequest::Automatic) キャッシュされた認証情報をリクエストで使用するかどうかを示します。これがQNetworkRequest::Manual に設定され、認証メカニズムが 'Basic' または 'Digest' の場合、Qt はリクエストの URL にキャッシュされた認証情報を 'Authorization' HTTP ヘッダとして送信しません。この属性は、リクエストを作成した Javascript によって withCredentials が明示的に true に設定されていないクロスオリジン XMLHttpRequest を作成するときに、Qt WebKit によってQNetworkRequest::Manual に設定されます。詳細はこちらを参照してください。(この値は 4.7 で導入されました)。 |
QNetworkRequest::BackgroundRequestAttribute | 17 | Type:QMetaType::Bool (default: false) ユーザ主導の転送ではなく、バックグラウンド転送であることを示す。プラットフォームによっては、バックグラウンド転送には異なるポリシーが適用されるかもしれません。 |
QNetworkRequest::Http2AllowedAttribute | 19 | Requests only, type:QMetaType::Bool (default: true) このリクエストでQNetworkAccessManager コードが HTTP/2 の使用を許可されているかどうかを示します。Http2CleartextAllowedAttribute が設定されている場合、これは SSL リクエストか 'cleartext' HTTP/2 に適用されます。 |
QNetworkRequest::Http2WasUsedAttribute | 20 | Replies only, type:QMetaType::Bool (default: false) このリプライの受信に HTTP/2 が使われたかどうかを示す。(この値は5.9で導入された)。 |
QNetworkRequest::EmitAllUploadProgressSignalsAttribute | 18 | Requests only, type:QMetaType::Bool (default: false) すべてのアップロードシグナルを発するかどうかを示す。デフォルトでは、uploadProgressシグナルは100ミリ秒間隔でのみ発信される。(この値は5.5で導入された)。 |
QNetworkRequest::OriginalContentLengthAttribute | 21 | 返信のみ、タイプQMetaType::Int データが圧縮され、リクエストが自動的に解凍されるようにマーク されたときに、無効化されてヘッダーから削除される前のオリジナルの content-length属性を保持する。(この値は5.9で導入された)。 |
QNetworkRequest::RedirectPolicyAttribute | 22 | リクエストのみ、type：QMetaType::Intには、QNetworkRequest::RedirectPolicy 値のいずれかを指定する必要がある(デフォルト:NoLessSafeRedirectPolicy)。(この値は5.9で導入された)。 |
QNetworkRequest::Http2DirectAttribute | 23 | Requests only, type:QMetaType::Bool (default: false) 設定されると、この属性はQNetworkAccessManager に最初の HTTP/2 プロトコルのネゴシエーションなしで HTTP/2 プロトコルを使わせます。この属性の使用は、特定のサーバが HTTP/2 をサポートしているという事前知識を意味します。Http2CleartextAllowedAttribute が設定されている場合、この属性は SSL または 'cleartext' HTTP/2 で動作します。HTTP/2 direct が指定されたときに、サーバが HTTP/2 をサポートしていないことが判明した場合、QNetworkAccessManager は、HTTP/1.1 にフォールバックしようとせずに、あきらめます。Http2AllowedAttributeとHttp2DirectAttributeの両方が設定されている場合、Http2DirectAttributeが優先される。(この値は5.11で導入された)。 |
QNetworkRequest::AutoDeleteReplyOnFinishAttribute | 25 | Requests only, type:QMetaType::Bool (default: false) この属性がセットされていると、QNetworkAccessManager が "finished "を発した後、QNetworkReply を削除する。(この値は5.14で導入されました)。 |
QNetworkRequest::ConnectionCacheExpiryTimeoutSecondsAttribute | 26 | リクエストのみ： QMetaType::Int サーバー(HTTP1とHTTP2)へのTCPコネクションを、最後の保留中のリクエストの処理後にいつ閉じるかを設定する。(この値は6.3で導入された)。 |
QNetworkRequest::Http2CleartextAllowedAttribute | 27 | Requests only, type:QMetaType::Bool (default: false) 設定すると、この属性はQNetworkAccessManager に、HTTP/2 over cleartext (h2c とも呼ばれます) へのアップグレードを試みるように指示します。Qt 7 までは、QT_NETWORK_H2C_ALLOWED 環境変数を設定することで、この属性のデフォルト値を true に上書きすることができます。Http2AllowedAttribute が設定されていない場合、この属性は無視されます。(この値は 6.3 で導入された)。 |
QNetworkRequest::UseCredentialsAttribute | 28 | Requests only, type:QMetaType::Bool (default: false) 基礎となる XMLHttpRequest のクロスサイトアクセスコントロールリクエストが認証情報を使って行われるべきかどうかを示します。同一オリジンのリクエストには影響しません。これは WebAssembly プラットフォームにのみ影響します。(この値は 6.5 で導入されました)。 |
QNetworkRequest::FullLocalServerNameAttribute | 29 | リクエストのみ、タイプQMetaType::StringQLocalSocket で使用される完全なローカルサーバ名を保持します。この属性は、QLocalSocket'の単純な名前のための動作が十分でないときに、特定のローカルサーバに接続するためにQNetworkAccessManager によって使用されます。QNetworkRequest のURLは、依然としてunix+http:またはlocal+http:スキームを使用しなければなりません。そして、URLのホスト名はHTTPリクエストのHostヘッダーに使われる。(この値は6.8で導入されました)。 |
QNetworkRequest::User | 1000 | 特殊型。追加情報は、UserからUserMaxまでのタイプを持つQVariantsで渡すことができます。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 ヘッダに対応し、disposition タイプ (例えば、添付ファイル) とパラメータ (例えば、ファイル名) を含む文字列を含みます。 |
QNetworkRequest::ContentTypeHeader | 0 | HTTP Content-Type ヘッダに対応し、メディア(MIME)タイプと補助データ(例えば charset)を含む文字列を含む。 |
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 | HTTPクライアントが送るUser-Agentヘッダ。 |
QNetworkRequest::ServerHeader | 8 | HTTPクライアントが受け取るServerヘッダー。 |
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 | 低い優先度 |
enum QNetworkRequest::RedirectPolicy
Network Access 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()シグナルを処理し、QNetworkReply オブジェクト上でredirectAllowed()を発行してリダイレクトを許可するか、中止/終了して リダイレクトを拒否するかによって、各リダイレクトに従うかどうかを決定する。これは例えば、リダイレクトを受け入れるかどうかをユーザーに尋ねたり、アプリ固有の設定に基づいて決定したりするために使用できます。 |
注意: Qt がリダイレクトを処理する場合、レガシーと互換性の理由から、サーバーが 301 または 302 応答を返したときは、元のメソッドが HEAD でない限り、それに関係なく GET を使ってリダイレクトされたリクエストを発行します。
enum QNetworkRequest::TransferTimeoutConstant
転送タイムアウトをプリセット値で有効にするために使用できる定数。
| 定数 | 値 | 説明 |
|---|---|---|
QNetworkRequest::DefaultTransferTimeoutConstant | 30000 | ミリ秒単位の転送タイムアウト。setTimeout() が引数なしで呼び出された場合に使用されます。 |
メンバ関数ドキュメント
QNetworkRequest::QNetworkRequest()
要求する URL がない QNetworkRequest オブジェクトを構築します。URL を設定するにはsetUrl() を使用します。
[explicit] QNetworkRequest::QNetworkRequest(const QUrl &url)
url を要求する URL として QNetworkRequest オブジェクトを構築します。
QNetworkRequest::QNetworkRequest(const QNetworkRequest &other)
other のコピーを作成する。
[noexcept] 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(QAnyStringView headerName) const
このネットワークリクエストに生ヘッダーheaderName が存在する場合、true を返します。
注意: Qt 6.7より前のバージョンでは、この関数はQByteArray のみを受け取りました。
rawHeader() およびsetRawHeader()も参照してください 。
QVariant QNetworkRequest::header(QNetworkRequest::KnownHeaders header) const
既知のネットワークヘッダheader がこのリクエストに存在する場合、その値を返す。存在しない場合は QVariant()(つまり無効な variant)を返す。
KnownHeaders 、rawHeader()、setHeader()も参照 。
[since 6.8] QHttpHeaders QNetworkRequest::headers() const
このネットワークリクエストで設定されているヘッダを返します。
この関数は Qt 6.8 で導入されました。
setHeaders()も参照してください 。
[since 6.5] QHttp1Configuration QNetworkRequest::http1Configuration() const
このリクエストの基礎となる HTTP/1 接続でQNetworkAccessManager が使用している現在のパラメータを返します。
この関数は 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 で設定された、証明書の検証用に設定されたホスト名を返します。デフォルトでは null 文字列を返します。
setPeerVerifyNameも参照 。
QNetworkRequest::Priority QNetworkRequest::priority() const
このリクエストの優先度を返す。
setPriority()も参照のこと 。
QByteArray QNetworkRequest::rawHeader(QAnyStringView headerName) const
ヘッダーheaderName の生の形式を返す。そのようなヘッダーが存在しない場合、空のQByteArray が返される。これは、ヘッダーは存在するが内容がないものと区別できないかもしれない (ヘッダーが存在するかどうかを調べるにはhasRawHeader() を使用する)。
生のヘッダはsetRawHeader() またはsetHeader() で設定できます。
注意: Qt 6.7 より前のバージョンでは、この関数はQByteArray のみでした。
header() およびsetRawHeader()も参照してください 。
QList<QByteArray> QNetworkRequest::rawHeaderList() const
このネットワークリクエストに設定されているすべての raw ヘッダーのリストを返す。リストはヘッダが設定された順番に並べられます。
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 を設定する。
サポートされている圧縮アルゴリズムによっては、小さな圧縮ファイルに、 驚くほど巨大な解凍ファイルをエンコードすることができます。これは、解凍されたコンテンツが非常に単調な場合にのみ可能であり、善意で送信される実際のファイルではめったにないことです。このような非常識に高い圧縮率を行使するファイルは、典型的にはバッファオーバーラン攻撃のペイロードであるか、サービス拒否攻撃（メモリを使いすぎることによって）です。その結果、特に小さな圧縮形式から巨大なサイズに解凍されるファイルは、マルウェアの疑いがあるとして拒否するのが最善です。
返信の解凍サイズがこのしきい値（デフォルトでは 10MiB、つまり 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)
リクエストの HTTP/1 パラメータをconfiguration から設定します。
この関数は Qt 6.5 で導入されました。
http1Configuration,QNetworkAccessManager,QHttp1Configurationも参照してください 。
void QNetworkRequest::setHttp2Configuration(const QHttp2Configuration &configuration)
リクエストの HTTP/2 パラメータをconfiguration から設定する。
注意: リクエストを行う前に設定を行う必要があります。
注意: HTTP/2は1つのHTTP/2接続で複数のストリームを多重化します。これは、QNetworkAccessManager が、同じホストに送られた一連のリクエストの最初のリクエストで見つかった設定を使うことを意味します。
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 はネットワークアクセスマネージャーへのヒントに過ぎない。それを使うことも使わないこともできる。現在のところ、どのリクエストを最初にサーバに送るかを決めるために HTTPで使われている。
priority()も参照のこと 。
void QNetworkRequest::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)
ヘッダーheaderName に値headerValue を設定する。headerName が既知のヘッダー(QNetworkRequest::KnownHeaders 参照)に対応する場合、生の書式が解析され、対応する「cooked」 ヘッダーも設定される。
例えば
request.setRawHeader(QByteArray("Last-Modified"), QByteArray("Sun, 06 Nov 1994 08:49:37 GMT"));
はまた、既知のヘッダーLastModifiedHeader を、解析された日付のQDateTime オブジェクトに設定する。
注意: 同じヘッダーを2回設定すると、前の設定が上書きされます。同じ名前のHTTPヘッダを複数設定するには、2つの値をカンマ(",")で区切って連結し、1つの生のヘッダを設定します。
注意: Qt 6.8以降、ヘッダーフィールド名は小文字に変換されて正規化されます。
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(std::chrono::milliseconds),transferTimeout(),transferTimeoutAsDuration()も参照 。
[since 6.7] void QNetworkRequest::setTransferTimeout(std::chrono::milliseconds duration = DefaultTransferTimeout)
データが交換されなかった場合に転送を中止するためのタイムアウトduration を設定する。
転送は、タイムアウトが切れる前にバイトが転送されなければ中止される。ゼロはタイマーが設定されないことを意味する。引数が与えられない場合、タイムアウトはQNetworkRequest::DefaultTransferTimeout となります。この関数が呼ばれない場合、タイムアウトは無効となり、値はゼロとなります。
この関数は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
データが交換されなかった場合に転送が中止されるタイムアウト時間を返します。
デフォルトの継続時間はゼロで、これはタイムアウトが使用されないことを意味します。
この関数は Qt 6.7 で導入されました。
setTransferTimeout(std::chrono::milliseconds)も参照してください 。
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!=()も参照 。
メンバ変数のドキュメント
const std::chrono::std::chrono::milliseconds QNetworkRequest::DefaultTransferTimeout
QNetworkRequest::TransferTimeoutConstant ミリ秒の転送タイムアウト。setTransferTimeout() が引数なしで呼び出された場合に使用される。
© 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.
