[iOS-Foundation] Networking Requ
对于在网络活动中的请求和响应,尤其是 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: