Type Method 型メソッド

sendAsynchronousRequest(_:queue:completionHandler:)

Loads the data for a URL request and executes a handler block on an operation queue when the request completes or fails. あるURLリクエストに対してデータをロードして、あるハンドラブロックをある演算キュー上でそのリクエストが完了または失敗する時に実行します。

Declaration 宣言

class func sendAsynchronousRequest(_ request: URLRequest, 
                             queue: OperationQueue, 
                 completionHandler handler: @escaping (URLResponse?, Data?, Error?) -> Void)

Parameters パラメータ

request

The URL request to load. The request object is deep-copied as part of the initialization process. Changes made to request after this method returns do not affect the request that is used for the loading process. ロードすることになるURLリクエスト。requestオブジェクトは、初期化処理の一部として深いコピーをされます。このメソッドが返った後にrequestになされる変更は、ロード処理に使われるリクエストに影響を及ぼしません。

queue

The operation queue to which the handler block is dispatched when the request completes or failed. リクエストが完了するまたは失敗した時にそれへとハンドラブロックがディスパッチされる演算キュー。

handler

The handler block to execute. 実行するハンドラブロック。

Discussion 議論

If the request completes successfully, the data parameter of the handler block contains the resource data, and the error parameter is nil. If the request fails, the data parameter is nil and the error parameter contain information about the failure. リクエストがうまく完了するならば、ハンドラブロックのdataパラメータはリソースデータを含みます、そしてerrorパラメータはnilです。リクエストが失敗するならば、dataパラメータはnilです、そしてエラーパラメータは失敗についての情報を含みます。

If authentication is required in order to download the request, the required credentials must be specified as part of the URL. If authentication fails, or credentials are missing, the connection will attempt to continue without credentials. If the request finishes with a 401 Unauthorized status code, the response parameter is nil, the data parameter contains the resource data, and the error parameter is an NSError with the NSURLErrorUserCancelledAuthentication code in the NSURLErrorDomain error domain. 認証がリクエストをダウンロードするために要求されるならば、要求される資格情報はURLの一部として指定されなければなりません。認証が失敗する、または資格情報が見つからないならば、接続は継続を資格情報なしで試みるでしょう。リクエストが401 Unauthorized状態コードで終了するならば、responseパラメータはnilです、dataパラメータはリソースデータを含みます、そしてerrorパラメータはNSURLErrorDomainエラードメインの中のNSURLErrorUserCancelledAuthenticationコードを持つNSErrorを含みます。

See Also 参照

Loading Data Asynchronously データを非同期にロードする