NSURLCache

@interface NSURLCache : NSObject

Overview 概要

The NSURLCache class implements the caching of responses to URL load requests, by mapping NSURLRequest objects to NSCachedURLResponse objects. It provides a composite in-memory and on-disk cache, and lets you manipulate the sizes of both the in-memory and on-disk portions. You can also control the path where cache data is persistently stored. NSURLCacheクラスは、URLロードリクエストに対する応答のキャッシュを実装します、NSURLRequestオブジェクトをNSCachedURLResponseオブジェクトにマッピングすることによって。それは、メモリ内およびディスク上キャッシュの複合物を提供します、そしてあなたにインメモリおよびオンディスク部分の両方のサイズを操作させます。あなたはまた、そこにおいてキャッシュデータが永続的に格納されるところのパスを制御できます。

Thread Safety スレッド安全

In iOS 8 and later, and macOS 10.10 and later, NSURLCache is thread safe. iOS 8以降、そしてmacOS 10.10以降では、NSURLCacheはスレッド安全です。

Although NSURLCache instance methods can safely be called from multiple execution contexts at the same time, be aware that methods like cachedResponseForRequest: and storeCachedResponse:forRequest: have an unavoidable race condition when attempting to read or write responses for the same request.

Subclasses of NSURLCache must implement overridden methods in such a thread-safe manner. NSURLCacheのサブクラスは、オーバーライドされたメソッドをそのようなスレッド安全な流儀で実装しなければなりません。

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

The NSURLCache class is meant to be used as-is, but you can subclass it when you have specific needs. For example, you might want to screen which responses are cached, or reimplement the storage mechanism for security or other reasons. NSURLCacheクラスは、そのままで使われることを意図されます、しかしあなたはそれのサブクラスを作ることができます、もしあなたが特別な需要を持つ時は。例えば、あなたはどの応答がキャッシュされるか選別したい、または保安または他の理由のために貯蔵の仕組みを再実装したいかもしれません。

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パラメータを取るメソッドは、そうしないものよりシステムによって好まれることを自覚しておいてください。それゆえに、あなたは、サブクラスを作る場合は、タスク基盤のメソッドをオーバーライドするべきです、次のように：

• Storing responses in the cache — Override the task-based storeCachedResponse:forDataTask:, instead of or in addition to the request-based storeCachedResponse:forRequest:. 応答をキャッシュに格納する — タスク基盤のstoreCachedResponse:forDataTask:をオーバーライドしてください、リクエスト基盤のstoreCachedResponse:forRequest:の代わりにまたはそれに加えて。

• Getting responses from the cache — Override getCachedResponseForDataTask:completionHandler:, instead of or in addition to cachedResponseForRequest:. 応答をキャッシュから取得する — getCachedResponseForDataTask:completionHandler:をオーバーライドしてください、cachedResponseForRequest:の代わりにまたはそれに加えて。

• Removing cached responses — Override the task-based removeCachedResponseForDataTask:, instead of or in addition to the request-based removeCachedResponseForRequest:. キャッシュされた応答を除去する — タスク基盤のremoveCachedResponseForDataTask:をオーバーライドしてください、リクエスト基盤のremoveCachedResponseForRequest:の代わりにまたはそれに加えて。