Type Method 型メソッド

sendSynchronousRequest(_:returning:)

Performs a synchronous load of the specified URL request. 指定されたURLリクエストの同期的ロードを実行します。

Declaration 宣言

class func sendSynchronousRequest(_ request: URLRequest, 
                        returning response: AutoreleasingUnsafeMutablePointer<URLResponse?>?) throws -> Data

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になされる変更は、ロード処理に使われるリクエストに影響を及ぼしません。

response

Out parameter for the URL response returned by the server. サーバーによって返されるURL応答に対するoutパラメータ。

error

Out parameter used if an error occurs while processing the request. May be NULL. リクエストを処理している間にエラーが発生するならば使われるoutパラメータ。NULLかもしれません。

Return Value 戻り値

The downloaded data for the URL request. Returns nil if a connection could not be created or if the download fails. そのURLリクエストに対してダウンロードされたデータ。nilを返します、もし接続が作成されることができなかったならばまたはダウンロードが失敗するならば。

Discussion 議論

A synchronous load is built on top of the asynchronous loading code made available by the class. The calling thread is blocked while the asynchronous loading system performs the URL load on a thread spawned specifically for this load request. No special threading or run loop configuration is necessary in the calling thread in order to perform a synchronous load. 同期的ロードは、クラスによって利用可能にされる非同期ロードコードの一番上に構築されます。呼び出しているスレッドは、非同期ローディングシステムがURLロードを実行している間はブロックされます、とりわけこのロードリクエストに対して生み出されたスレッド上では。特別なスレッディングまたは実行ループ構成設定は、その呼び出しているスレッドにおいては同期的ロードを実行する手段として必要ではありません。

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. 認証がリクエストをダウンロードするために要求されるならば、要求される資格情報はURLの一部として指定されなければなりません。認証が失敗する、または資格情報が見つからないならば、接続は継続を資格情報なしで試みるでしょう。