Structure

URLRequest

A URL load request that is independent of protocol or URL scheme. URLロード要請、それはプロトコルまたはURLスキームから独立しています。

Declaration 宣言 

struct URLRequest

Overview 概要

URLRequest encapsulates two essential properties of a load request: the URL to load and the policies used to load it. In addition, for HTTP and HTTPS requests, URLRequest includes the HTTP method (GET, POST, and so on) and the HTTP headers. URLRequest は、あるロードリクエストの２つの本質的プロパティをカプセル化します：ロードするURLとそれをロードするのに使われる方針。加えて、HTTPおよびHTTPSリクエストに対して、URLRequestは、HTTPメソッド（GET、POST、など）そしてHTTPヘッダを含みます。

URLRequest only represents information about the request. Use other classes, such as URLSession, to send the request to a server. See Fetching Website Data into Memory and Uploading Data to a Website for an introduction to these techniques. URLRequestは、リクエストについての情報を表すだけです。他のクラス、たとえばURLSessionを使って、リクエストをサーバーに送信してください。ウェブサイトデータをメモリに取って来るとデータをウェブサイトにアップロードするをこれらのテクニックに対する導入として見てください。

When writing Swift code, favor this structure over the NSURLRequest and NSMutableURLRequest classes. Swiftコードを記述している場合、この構造体をNSURLRequestおよびNSMutableURLRequestクラスより優遇してください。

Certain header fields are reserved; see Reserved HTTP Headers. 特定のヘッダフィールドいくらかは予約されます；予約済みHTTPヘッダを見てください。

Topics 話題

Creating a Request リクエストを作成する

init(url: URL, cachePolicy: URLRequest.CachePolicy, timeoutInterval: TimeInterval)
Creates and initializes a URL request with the given URL, cache policy, and timeout interval. URLリクエストをこの与えられたURL、キャッシュ方針、そしてタイムアウト間隔で作成して初期化します。

Working with a Cache Policy キャッシュ方針を扱う

var cachePolicy: URLRequest.CachePolicy
The request’s cache policy. その要請のもつキャッシュ方針。
typealias URLRequest.CachePolicy
An alias for the cache policy. キャッシュ方針に対するエイリアス。
enum NSURLRequest.CachePolicy
The constants used to specify interaction with the cached responses. キャッシュされた応答との相互作用を指定するのに使われる定数。

Accessing Request Components 要請構成要素にアクセスする

var httpMethod: String?
The HTTP request method. HTTPリクエストメソッド。
var url: URL?
The URL of the request. リクエストのURL。
var httpBody: Data?
The data sent as the message body of a request, such as for an HTTP POST request. あるリクエストのメッセージ本文として送られるデータ、たとえばHTTP POSTリクエスト。
var httpBodyStream: InputStream?
The stream used to deliver the HTTP body. HTTP本文を配達するのに使われるストリーム。
var mainDocumentURL: URL?
The main document URL associated with this request. このリクエストと結び付けられるメインドキュメントURL。

Accessing Header Fields ヘッダフィールドにアクセスする

var allHTTPHeaderFields: [String : String]?
A dictionary containing all of the HTTP header fields for a request. あるリクエストに対するHTTPヘッダフィールドの全てを含んでいる辞書。
func addValue(String, forHTTPHeaderField: String)
Adds a value to the header field. ある値をヘッダフィールドに加えます。
func setValue(String?, forHTTPHeaderField: String)
Sets a value for the header field. ある値をヘッダフィールドに対して設定します。
func value(forHTTPHeaderField: String) -> String?
Retrieves a header value. ヘッダ値を取ってきます。

Controlling Request Behavior リクエスト挙動を制御する

var timeoutInterval: TimeInterval
The timeout interval of the request. リクエストのタイムアウト間隔。
var httpShouldHandleCookies: Bool
A Boolean value indicating whether cookies will be sent with and set for this request. クッキーがこのリクエストで送信されるおよびそれに対して設定されるかどうかを指し示しているブール値。
var httpShouldUsePipelining: Bool
A Boolean value indicating whether the request should transmit before the previous response is received. リクエストは以前の応答が受け取られる前に送信するべきかどうかを指し示しているブール値。
var allowsCellularAccess: Bool
A Boolean value indicating whether the request is allowed to use the built-in cellular radios to satisfy the request. リクエストは組み込みセルラー無線を使ってリクエストを履行することを許可されるかどうかを指し示しているブール値。

Supporting Limited Modes 制限モードをサポートする

var allowsConstrainedNetworkAccess: Bool
A Boolean value that indicates whether the request may use the network when the user has specified Low Data Mode. あるブール値、それはユーザがLow Data Modeを指定する場合にリクエストがネットワークを使うかもしれないかどうかを指し示します。
var allowsExpensiveNetworkAccess: Bool
A Boolean value that indicates whether connections may use a network interface that the system considers expensive. システムが高くつくと考えるネットワークインターフェイスを接続が使うかもしれないかどうかを指し示すブール値。

Accessing the Service Type サービス型にアクセスする

var networkServiceType: URLRequest.NetworkServiceType
The service type associated with this request. このリクエストと結び付けられるサービス型。
typealias URLRequest.NetworkServiceType
An alias for the network service type. ネットワークサービス型に対するエイリアス。
enum NSURLRequest.NetworkServiceType
Constants that specify how a request uses network resources. どのようにあるリクエストがネットワークリソースを使うかを指定する定数。

Indicating the Source of the Request リスエストのソースを指し示す

var attribution: URLRequest.Attribution
The entity that initiates the network request. ネットワークリクエストに着手する実在。
typealias URLRequest.Attribution
A type that indicates the entities that can make a network request.

Comparing Requests リクエストそれらを比較する

static func != (URLRequest, URLRequest) -> Bool
Returns a Boolean value indicating whether two values are not equal. ２つの値が等しくないかどうかを指し示すブール値を返します。
static func == (URLRequest, URLRequest) -> Bool
Indicates whether two URL requests are the same. ２つのURLリクエストが同じかどうかを指し示します。

Describing Requests リクエストを記述する

var description: String
A textual description of the request. リクエストのテキスト記述。
var debugDescription: String
A textual description of the request suitable for debugging. デバッグに適する、リクエストのテキスト記述。
var customMirror: Mirror
A mirror that reflects the request. リクエストを反映するミラー。
var hashValue: Int
The computed hash value for the request. リクエストに対する計算ハッシュ値。

Using Reference Types 参照型を使用する

class NSURLRequest
A representation of a URL load request that you use when you need reference semantics or other Foundation-specific behavior. URLロードリクエストのある表現、それはあなたが参照意味論や他のFoundation特有の挙動を必要とする場合にあなたが使うものです。
class NSMutableURLRequest
A mutable URL load request that bridges to NSURLRequest and you use when you need reference semantics or other Foundation-specific behavior. ある可変URLロードリクエスト、それはNSURLRequestにブリッジします、そしあなたが参照意味論や他のFoundation特有の挙動を必要とする場合は使ってください。
typealias MutableURLRequestDeprecated 非推奨
typealias URLRequest.ReferenceType
An alias for this value type's equivalent reference type. この値型のもつ同等な参照型に対するエイリアス。

Instance Properties インスタンスプロパティ

var assumesHTTP3Capable: Bool

Instance Methods インスタンス メソッド

func hash(into: inout Hasher)

Relationships 関係

Conforms To 次に準拠

See Also 参照

Requests and Responses 要請と応答

class URLResponse
The metadata associated with the response to a URL load request, independent of protocol and URL scheme. あるURLロード要請への応答と結び付けられたメタデータ、それはプロトコルまたはURLスキームから独立しています。
class HTTPURLResponse
The metadata associated with the response to an HTTP protocol URL load request. あるHTTPプロトコルURLのロード要請に対する応答と結び付けられるメタデータ。