Type Method 型メソッド

canonicalRequest(for:)

Returns a canonical version of the specified request. 指定されたリクエストの正準版を返します。

Declaration 宣言

class func canonicalRequest(for request: URLRequest) -> URLRequest

Parameters パラメータ

request

The request whose canonical version is desired. それの正準版が望まれるところのリクエスト。

Return Value 戻り値

The canonical form of request. requestの正準版。

Discussion 議論

It is up to each concrete protocol implementation to define what “canonical” means. A protocol should guarantee that the same input request always yields the same canonical form. “正準 canonical” が意味することを定義するのは、それぞれ具体的なプロトコル実装の責任です。あるプロトコルは、同じ入力リクエストが常に同じ正準形式を生成することを保障すべきです。

Special consideration should be given when implementing this method, because the canonical form of a request is used to lookup objects in the URL cache, a process which performs equality checks between URLRequest instances. 特別な配慮がこのメソッドを実装する時にされるべきです、なぜならあるリクエストの正準形式はURLキャッシュにおいてオブジェクトを捜すのに、同等性検査をURLRequestインスタンス間で実行するプロセスに、使われるからです。

This is an abstract method and subclasses must provide an implementation. これは抽象メソッドです、そしてサブクラスは実装を提供しなければなりません。