[iOS-Foundation] Networking Request and Response

对于在网络活动中的请求和响应，尤其是 HTTP 协议，Foundation 框架提供了相应的类来封装这些信息。URL Loading System 的 API 会提供这些类的实例来传递相关信息。

Request

Foundation 框架中，通过 NSURLRequest 类封装了对一个 URL 请求的信息。

通过所要请求资源的NSURL实例来创建NSURLRequest实例，除了使用默认的使用缓存策略和超时时间外，还可以在创建时通过传入参数设置。

+ requestWithURL:
- initWithURL:
+ requestWithURL:cachePolicy:timeoutInterval:
- initWithURL:cachePolicy:timeoutInterval:

NSURLRequest类内的部分属性设置了请求时的行为，它们与在 configuration 中的设置是重合的。configuration 设置了 session 内所有请求 task 的行为，而NSURLRequest则只影响所在 task。优先级是 request 覆盖 configuration。

• cachePolicy，枚举类型 NSURLRequestCachePolicy，指明了请求使用缓存响应的策略。

// 默认值，使用协议本身的缓存逻辑。
NSURLRequestUseProtocolCachePolicy
// 不使用现有缓存，数据需要从原始地址加载。
NSURLRequestReloadIgnoringLocalCacheData
// 无论缓存是否过期，先使用本地缓存数据。如果缓存中没有请求所对应的数据，那么从原始地址加载数据。
NSURLRequestReturnCacheDataElseLoad
// 无论缓存是否过期，先使用本地缓存数据。如果缓存中没有请求所对应的数据，那么放弃从原始地址加载数据，请求视为失败。
NSURLRequestReturnCacheDataDontLoad

• timeoutInterval，请求的超时时间，默认值为60秒。
• networkServiceType，NSURLRequestNetworkServiceType类型，network service type 影响着操作系统对于网络传输的优先级排列，进而影响系统电量、性能的消耗。默认值是NSURLNetworkServiceTypeDefault。
• HTTPShouldUsePipelining，布尔值，说明 session 内的 task 是否使用 HTTP pipelining。
• allowsCellularAccess，布尔值，指明在移动网络下是否可发起请求。

当然NSURLRequest类还包括一个指明请求资源 URL 的NSURL类型属性URL，以及用于 cookie 保存策略
NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain的mainDocumentURL属性。

除了上述基本属性外，NSURLRequest类内还包括一些 HTTP 协议相关的属性和方法：

HTTPBody
HTTPBodyStream
HTTPMethod
HTTPShouldHandleCookies
allHTTPHeaderFields
- valueForHTTPHeaderField

在NSURLRequest类中，大部分属性是只读的，创建后无法修改，只能使用默认值。Foundation 框架还提供了一个NSURLRequest的子类 NSMutableURLRequest，在该类的实例创建后，可以单独的修改属性的值，当然也提供了相应的修改的方法

- addValue:forHTTPHeaderField:
- setValue:forHTTPHeaderField:

Response

Foundation 框架提供 NSURLResponse 类封装对 URL 请求的响应的元数据。可通过方法- initWithURL:MIMEType:expectedContentLength:textEncodingName:创建。通过以下属性保存了响应信息：

URL
MIMEType
expectedContentLength
textEncodingName
suggestedFilename

另外 Foundation 框架提供了NSURLResponse的子类 NSHTTPURLResponse 类，来封装 HTTP 协议相关的响应信息。通过方法
- initWithURL:statusCode:HTTPVersion:headerFields:创建。额外提供的属性有

statusCode
allHeaderFields

以及一个提供 HTTP 响应状态码的对应本地化字符串的方法
- localizedStringForStatusCode: