NSURLDownloadDelegate

Overview 概要

The NSURLDownloadDelegate protocol defines methods that allow an object to receive informational callbacks about the asynchronous load of a download’s URL request. Other delegate methods provide facilities that allow the delegate to customize the process of performing an asynchronous URL load. NSURLDownloadDelegateプロトコルは、あるダウンロードの持つURLリクエストの非同期ロードについてのコールバック情報を受け取ることをあるオブジェクトに可能にするメソッドを定義します。その他の委任先メソッドはさまざまな設備を提供します、それらは、委任先が非同期URLロードを実行する過程をカスタマイズできるようにするものです。

Note that these delegate methods will be called on the thread that started the asynchronous load operation for the associated NSURLDownload object. これらの委任先メソッドは、結びつけられたNSURLDownloadオブジェクトに対する非同期ロード演算を開始したスレッド上で呼び出されることに注意してください。

• A downloadDidBegin(_:) message will be sent to the delegate immediately upon starting the download. downloadDidBegin(_:)メッセージが、ダウンロードを開始すると直ぐに委任先に送られます。

• Zero or more download(_:willSend:redirectResponse:) messages will be sent to the delegate before any further messages are sent if it is determined that the download must redirect to a new location. The delegate can allow the redirect, modify the destination or deny the redirect. ゼロ以上のdownload(_:willSend:redirectResponse:)メッセージが、もしダウンロードを新しい位置へと向け直す必要があると決定されるならば、何らかのそれ以上のメッセージが送られる前に、委任先へと送られます。委任先は、リダイレクトを許可する、行き先を修正するまたはリダイレクトを拒絶することができます。

• Zero or more download(_:didReceive:) messages will be sent to the delegate if it is necessary to authenticate in order to download the request and NSURLDownload does not already have authenticated credentials. ゼロ以上のdownload(_:didReceive:)メッセージが委任先に送られます、もしリクエストをダウンロードするために認証が必要であるそしてNSURLDownloadがまだ認証された資格情報を持たないならば。

• Zero or more download(_:didCancel:) messages will be sent to the delegate if NSURLDownload cancels the authentication challenge due to encountering a protocol implementation error. ゼロ以上のdownload(_:didCancel:)メッセージが委任先に送られます、もしNSURLDownloadが認証チャレンジをプロトコル実装エラーに出くわすせいでキャンセルするならば。

• Zero or more download(_:didReceive:) messages will be sent to the delegate before receiving a download(_:didReceiveDataOfLength:) message. The only case where download(_:didReceive:) is not sent to a delegate is when the protocol implementation encounters an error before a response could be created. ゼロ以上のdownload(_:didReceive:)メッセージが、download(_:didReceiveDataOfLength:)メッセージを受け取る前に、委任先に送られます。download(_:didReceive:)が委任先に送られない唯一の事例は、ある応答が作成されることが可能になる前に、プロトコル実装がエラーに出くわす場合です。

• Zero or more download(_:didReceiveDataOfLength:) messages will be sent before downloadDidFinish(_:) or download(_:didFailWithError:) is sent to the delegate. ゼロ以上のdownload(_:didReceiveDataOfLength:)メッセージが、downloadDidFinish(_:)またはdownload(_:didFailWithError:)が委任先に送られる前に、送られます。

• Zero or one download(_:decideDestinationWithSuggestedFilename:) will be sent to the delegate when sufficient information has been received to determine the suggested filename for the downloaded file. The delegate will not receive this message if setDestination(_:allowOverwrite:) has already been sent to the NSURLDownload instance. ゼロまたは１つのdownload(_:decideDestinationWithSuggestedFilename:)が委任先に送られます、十分な情報が受け取られてそのダウンロードされたファイルに対して提案ファイル名を決定する場合には。委任先はこのメッセージを受け取りません、もしsetDestination(_:allowOverwrite:)が既にNSURLDownloadインスタンスに送られたならば。

• A download(_:didCreateDestination:) message will be sent to the delegate when the NSURLDownload instance creates the file on disk. download(_:didCreateDestination:)メッセージが委任先に送られます、NSURLDownloadインスタンスがファイルをディスク上で作成する場合には。

• If NSURLDownload determines that the downloaded file is in a format that it is able to decode (MacBinary, Binhex or gzip), the delegate will receive a download(_:shouldDecodeSourceDataOfMIMEType:). The delegate should return true to decode the data, false otherwise. NSURLDownloadが、ダウンロードされたファイルがそれがデコード可能である形式（MacBinary、Binhexまたはgzip）であると決定するならば、委任先はdownload(_:shouldDecodeSourceDataOfMIMEType:)を受け取ります。委任先は、データをデコードするためにtrueを、そうでなければfalseを返すべきです。

• Unless an NSURLDownload instance receives a cancel() message, the delegate will receive one and only one downloadDidFinish(_:) or download(_:didFailWithError:) message, but never both. In addition, once either of these messages are sent, the delegate will receive no further messages for the given NSURLDownload. NSURLDownloadインスタンスがcancel()メッセージを受け取らない限り、委任先は１つだけdownloadDidFinish(_:)またはdownload(_:didFailWithError:)メッセージを受け取ります、しかし決して両方ではありません。加えて、一旦それらメッセージのどちらかが送られるならば、委任先は与えられたNSURLDownloadに対してそれ以降のメッセージを受け取りません。