class func canHandle (URLRequest) -> Bool
Overview 概要
Important 重要
This API is considered legacy. Use URLSession
instead.
このAPIは、レガシーとみなされます。URLSession
を代わりに使ってください。
An NSURLConnection
object lets you load the contents of a URL by providing a URL request object. The interface for NSURLConnection
is sparse, providing only the controls to start and cancel asynchronous loads of a URL request. You perform most of your configuration on the URL request object itself.
NSURLConnection
オブジェクトは、あなたにURLリクエストオブジェクトを提供することによってあるURLのコンテンツをロードさせます。NSURLConnection
に対するインターフェイスはわずかです、URLリクエストの非同期ロードの開始とキャンセルの制御だけを提供します。あなたは、あなたの構成設定のほとんどをURLリクエストオブジェクトそれ自体の上で実行します。
Note 注意
Although instances of this class are commonly called “connections”, there is not a 1:1 correlation between these objects and the underlying network connections. たとえこのクラスのインスタンスが一般的に “接続” と呼ばれるとはいえ、オブジェクトと基底ネットワーク接続の間の 1:1 の相関関係ではありません。
The NSURLConnection
class provides convenience class methods to load URL requests both asynchronously using a callback block and synchronously.
NSURLConnection
クラスは、コールバックブロックを使っている非同期的そして同期的にの両方でURLリクエストをロードするために便宜クラスメソッドを提供します。
For greater control, you can create a URL connection object with a delegate object that conforms to the NSURLConnection
and NSURLConnection
protocols. The connection calls methods on that delegate to provide you with progress and status as the URL request is loaded asynchronously. The connection also calls delegate methods to let you override the connection’s default behavior (for example, specifying how a particular redirect should be handled). These delegate methods are called on the thread that initiated the asynchronous load operation.
より多くの制御のために、あなたはURL接続オブジェクトを、NSURLConnection
とNSURLConnection
プロトコルに準拠する委任先オブジェクトで作成できます。接続は、メソッドをその委任先の上で呼び出すことで、URLリクエストが非同期にロードされるにつれて、あなたに進捗および状態を提供します。接続はまた、委任先のメソッドを呼び出すことで、あなたに接続の持つ省略時の挙動(例えば、どのように個々のリダイレクトが取り扱われるべきかの指定)をオーバーライドさせます。これら委任先のメソッドが呼び出されるのは、非同期ロード演算が初期化されたスレッド上で、です。
Note 注意
During a request, the connection maintains a strong reference to its delegate. It releases that strong reference when the connection finishes loading, fails, or is canceled. あるリクエストの間、接続はそれの委任先への強い参照を保守します。それがその強い参照を開放するのは、接続がロードを完了、失敗、またはキャンセルされる時です。
For more information about errors, see the NSURLError
header, Foundation Constants
, and URL Loading System Error Codes in Error Handling Programming Guide.
エラーについてのさらなる情報として、NSURLError
ヘッダ、Foundation Constants
、そしてURL Loading System Error CodesをError Handling Programming Guideで見てください。
NSURLConnection Protocols NSURLConnectionプロトコル
The NSURLConnection
class works in tandem with three formal protocols: NSURLConnection
, NSURLConnection
, and NSURLConnection
. To use these protocols, you write a class that conforms to them and implement any methods that are appropriate, then provide an instance of that class as the delegate when you create a connection object.
NSURLConnection
クラスは3つの形式プロトコル:NSURLConnection
、NSURLConnection
、そしてNSURLConnection
と協力して働きます。これらのプロトコルを使うには、あなたはそれらに準拠するあるクラスを記述して、適切であるどんなメソッドでも実装します、それからそのクラスのインスタンスを委任先としてあなたが接続オブジェクトを作成する時に提供します。
The NSURLConnection
protocol is primarily used for credential handling, but also handles connection completion. Because it handles connection failure during data transfers, all connection delegates must typically implement this protocol.
NSURLConnection
プロトコルは、主として資格情報の取り扱いに使われます、しかしまた接続完了も取り扱います。それがデータ転送の間に接続失敗を取り扱うことから、全ての接続委任先は、概してこのプロトコルを実装しなければいけません。
In addition, unless you’re using Newsstand Kit, your delegate must also conform to the NSURLConnection
protocol, because this protocol provides methods that the NSURLConnection
class calls with progress information during an upload, with fragments of the response data during a download, and to provide a new upload body stream if the server’s response necessitates a second connection attempt—for example, if NSURLConnection
must retry the request with different credentials.
加えて、あなたがNewsstand Kitを使う場合を除いて、あなたの委任先はまたNSURLConnection
プロトコルに準拠しなければいけません、なぜならこのプロトコルはNSURLConnection
クラスが進捗情報とともにアップロードの間に、返答データの断片とともにダウンロードの間に呼び出すいくつかのメソッドを提供するからです、そしてもしサーバーの持つ返答が第2の接続の試みを必要とするならば — 例えば、NSURLConnection
が異なる資格情報を持つリクエストを再び試みなければならないならば、新しいアップロードボディストリームを提供するために。
Finally, if you’re using Newsstand Kit, your delegate can conform to the NSURLConnection
protocol. This protocol provides support for continuing interrupted file downloads and receiving a notification whenever a download finishes. This protocol is solely for use with NSURLConnection
objects created using Newsstand Kit’s download(with:)
method.
最後に、あなたがNewsstand Kitを使っているならば、あなたの委任先はNSURLConnection
プロトコルに準拠できます。このプロトコルは、割り込まれたファイルダウンロードを継続することそしてダウンロードが完了する時はいつでも通知を受け取ることに対するサポートを提供します。このプロトコルは、Newsstand Kitのもつdownload(with:)
メソッドを使って作成されるNSURLConnection
オブジェクトで使うためだけのものです。
Note 注意
Some methods in these protocols were previously part of other formal protocols or were previously part of an informal protocol on NSObject
.
これらプロトコルの中のいくつかのメソッドは、以前は他の形式プロトコルの一部でした、または以前はNSObject
に関する非形式プロトコルの一部でした。