NSURLProtocol

Overview 概要

Don't instantiate an NSURLProtocol subclass directly. Instead, create subclasses for any custom protocols or URL schemes that your app supports. When a download starts, the system creates the appropriate protocol object to handle the corresponding URL request. You define your protocol class and call the registerClass: class method during your app’s launch time so that the system is aware of your protocol. NSURLProtocolサブクラスを直接にインスタンス化しないでください。その代わりに、何らかのあつらえのプロトコルまたはあなたのアプリがサポートするURLスキームに対するサブクラスを作成してください。あるダウンロードが始まる時、システムは適切なプロトコルオブジェクトを作成して、対応するURLリクエストを取り扱います。あなたは、あなたのプロトコルクラスを定義して、registerClass:クラスメソッドをあなたのアプリのもつ起動時間の間に呼び出します、それでシステムはあなたのプロトコルを知っています。

To support the customization of protocol-specific requests, define categories on NSURLRequest and NSMutableURLRequest with any custom API that you need. You can store and retrieve protocol-specific request data by using NSURLProtocol’s class methods propertyForKey:inRequest: and setProperty:forKey:inRequest:. プロトコル特有リクエストのカスタマイゼーションをサポートするには、カテゴリをNSURLRequestとNSMutableURLRequest上で、あなたが必要とする何らかのあつらえのAPIで定義してください。あなたはプロトコル特有リクエストデータの格納および回収を、NSURLProtocolのもつクラスメソッドpropertyForKey:inRequest:とsetProperty:forKey:inRequest:を使うことによって行えます。

Create a NSURLResponse for each request your subclass processes successfully. You may want to create a custom, mutable NSURLResponse class to provide protocol specific information. NSURLResponseをあなたのサブクラスがうまく処理する各リクエストに対して作成してください。あなたは、あつらえの、可変NSURLResponseクラスを作成して、プロトコル特有の情報を提供したいかもしれません。

Subclassing Notes サブクラス作成の注意

When overriding methods of this class, be aware that methods that take a task parameter are preferred by the system to those that do not. Therefore, you should override the task-based methods when subclassing, as follows: このクラスのメソッドをオーバーライドする場合、taskパラメータを取るメソッドは、そうしないものよりシステムによって好まれることを自覚しておいてください。それゆえに、あなたは、サブクラスを作る場合は、タスク基盤のメソッドをオーバーライドするべきです、次のように：

• Initialization — Override canInitWithTask: and initWithTask:cachedResponse:client: instead of or in addition to canInitWithRequest: and initWithRequest:cachedResponse:client:. 初期化 — canInitWithTask:とinitWithTask:cachedResponse:client:をオーバーライドしてください、canInitWithRequest:とinitWithRequest:cachedResponse:client:の代わりにまたはそれに加えて。