版本记录

前言

我们做APP发起网络请求，一般都是使用框架，这些框架的底层也都是苹果的API，接下来几篇就一起来看一下和网络有关的几个类。感兴趣的可以看上面几篇文章。
1. 详细解析几个和网络请求有关的类 （一） —— NSURLSession
2. 详细解析几个和网络请求有关的类（二） —— NSURLRequest和NSMutableURLRequest
3. 详细解析几个和网络请求有关的类（三） —— NSURLConnection
4. 详细解析几个和网络请求有关的类（四） —— NSURLSession和NSURLConnection的区别
5. 详细解析几个和网络请求有关的类（五） —— 关于NSURL加载系统（一）
6. 详细解析几个和网络请求有关的类（六） —— 使用NSURLSession（二）
7. 详细解析几个和网络请求有关的类（七） —— URL数据的编码和解码（三）
8. 详细解析几个和网络请求有关的类（八） —— 处理重定向和其他请求更改（四）
9. 详细解析几个和网络请求有关的类（九） —— 身份验证挑战和TLS链验证（五）
10. 详细解析几个和网络请求有关的类（十） —— 理解获取缓存（六）
11. 详细解析几个和网络请求有关的类（十一） —— Cookies和自定义协议（七）
12. 详细解析几个和网络请求有关的类（十二） —— URL Session的生命周期（八）
13. 详细解析几个和网络请求有关的类（十三） —— NSURLResponse（一）
14. 详细解析几个和网络请求有关的类（十四） —— NSHTTPCookie（一）
15. 详细解析几个和网络请求有关的类（十五） —— NSHTTPCookieStorage（一）
16. 详细解析几个和网络请求有关的类（十六） —— NSURLCache（一）

回顾

上一篇讲述了NSURLCache这个类的详细信息以及一些注意要点，下面这篇我们就主要看一下NSCachedURLResponse。

Overview

对URL请求的缓存响应。

首先看一下基本信息

NSCachedURLResponse对象以NSURLResponse对象的形式提供服务器的响应元数据，以及包含实际缓存的内容数据的NSData对象。 其存储策略决定响应是应该缓存在磁盘上，内存中还是根本不缓存。

缓存的响应还包含用户信息字典，您可以在其中存储有关缓存项目的特定于应用程序的信息。

NSURLCache类存储和检索NSCachedURLResponse的实例。

Topics

1. Creating a cached URL response - 创建一个缓存的URL响应

• - initWithResponse:data:
  • 初始化一个NSCachedURLResponse对象。
• - initWithResponse:data:userInfo:storagePolicy:`
  • 初始化一个NSCachedURLResponse对象。

2. Getting cached URL response properties - 获取缓存的响应属性

• data
  • 接收的缓存数据。
• response
  • 与接收者关联的URL response对象。
• storagePolicy
  • 接收者的缓存存储策略。
• userInfo
  • 接受者的info字典。

3. Constants

• NSURLCacheStoragePolicy
  • 这些常量指定NSCachedURLResponse对象使用的缓存策略。

API文档

下面我们就看一下API文档。

/*!
    @class NSCachedURLResponse
    NSCachedURLResponse is a class whose objects functions as a wrapper for
    objects that are stored in the framework's caching system. 
    It is used to maintain characteristics and attributes of a cached 
    object. 
*/
// NSCachedURLResponse是一个类，其对象充当存储在框架缓存系统中的对象的包装器。 
// 它用于维护缓存对象的特征和属性。

@interface NSCachedURLResponse : NSObject <NSSecureCoding, NSCopying>
{
    @private
    NSCachedURLResponseInternal *_internal;
}

/*! 
    @method initWithResponse:data
    @abstract Initializes an NSCachedURLResponse with the given
    response and data.
    @discussion A default NSURLCacheStoragePolicy is used for
    NSCachedURLResponse objects initialized with this method:
    NSURLCacheStorageAllowed.
    @param response a NSURLResponse object.
    @param data an NSData object representing the URL content
    corresponding to the given response.
    @result an initialized NSCachedURLResponse.
*/
// 默认NSURLCacheStoragePolicy用于通过此方法初始化的NSCachedURLResponse对象：NSURLCacheStorageAllowed
// response：一个NSURLResponse对象
// data：表示与给定响应对应的URL内容的NSData对象

- (instancetype)initWithResponse:(NSURLResponse *)response data:(NSData *)data;

/*! 
    @method initWithResponse:data:userInfo:storagePolicy:
    @abstract Initializes an NSCachedURLResponse with the given
    response, data, user-info dictionary, and storage policy.
    @param response a NSURLResponse object.
    @param data an NSData object representing the URL content
    corresponding to the given response.
    @param userInfo a dictionary user-specified information to be
    stored with the NSCachedURLResponse.
    @param storagePolicy an NSURLCacheStoragePolicy constant.
    @result an initialized NSCachedURLResponse.
*/
// 根据一个给定的response、data、user-info字典和存储策略初始化一个NSCachedURLResponse对象。
// userInfo: 一个字典用户指定的信息与NSCachedURLResponse一起存储

- (instancetype)initWithResponse:(NSURLResponse *)response data:(NSData *)data userInfo:(nullable NSDictionary *)userInfo storagePolicy:(NSURLCacheStoragePolicy)storagePolicy;

/*!
    @abstract Returns the response wrapped by this instance. 
    @result The response wrapped by this instance. 
*/
// 返回由此实例包装的响应

@property (readonly, copy) NSURLResponse *response;

/*!
    @abstract Returns the data of the receiver. 
    @result The data of the receiver. 
*/
// 返回接收器的数据

@property (readonly, copy) NSData *data;

/*!
    @abstract Returns the userInfo dictionary of the receiver. 
    @result The userInfo dictionary of the receiver. 
*/
// 返回接收者的userInfo字典

@property (nullable, readonly, copy) NSDictionary *userInfo;

/*!
    @abstract Returns the NSURLCacheStoragePolicy constant of the receiver. 
    @result The NSURLCacheStoragePolicy constant of the receiver. 
*/
// 返回接收器的NSURLCacheStoragePolicy常量

@property (readonly) NSURLCacheStoragePolicy storagePolicy;

@end

NSURLRequest这里和NSCachedURLResponse是对应的关系。通过这样的映射关系实现缓存。这里存的是NSCachedURLResponse，也就是说这里的NSURLCache也是一个类似于NSCache的容器，只不过data是NSCachedURLResponse对象. 并不是类似于image这样的data。

后记

本篇主要讲述NSCachedURLResponse类的基本情况和使用。