一揍很、NSURLSessionConfiguration的描述
NSURLSessionConfiguration為NSURLSession配置一些請求所需要的策略廊宪。如:超時(shí)、緩存策略女轿、鏈接需求的。
NSURLSession會(huì)拷貝configuration壕翩。所以session一旦初始化結(jié)束就不會(huì)再更改configuration蛉迹。除非初始化一個(gè)session。
重要:如果NSURLRequest中也做了一些指定放妈。session也會(huì)遵循NSURLRequest的限定北救,但是如果configuration有更加嚴(yán)格的限定荐操,仍以configuration為主。
二珍策、defaultSessionConfiguration
默認(rèn)配置使用的是持久化的硬盤緩存托启,存儲(chǔ)證書到用戶鑰匙鏈。存儲(chǔ)cookie到shareCookie攘宙。
標(biāo)注:如果想要移植原來基于NSURLConnect的代碼到NSURLSession屯耸,可使用該默認(rèn)配置,然后再根據(jù)需要定制該默認(rèn)配置蹭劈。
三疗绣、ephemeralSessionConfiguration
返回一個(gè)不適用永久持存cookie、證書铺韧、緩存的配置多矮,最佳優(yōu)化數(shù)據(jù)傳輸。
標(biāo)注:當(dāng)程序作廢session時(shí)哈打,所有的ephemeral session 數(shù)據(jù)會(huì)立即清除塔逃。此外,如果你的程序處于暫停狀態(tài)料仗,內(nèi)存數(shù)據(jù)可能不會(huì)立即清除湾盗,但是會(huì)在程序終止或者收到內(nèi)存警告或者內(nèi)存壓力時(shí)立即清除。
四罢维、backgroundSessionConfigurationWithIdentifier
生成一個(gè)可以上傳下載HTTP和HTTPS的后臺(tái)任務(wù)(程序在后臺(tái)運(yùn)行)淹仑。
在后臺(tái)時(shí),將網(wǎng)絡(luò)傳輸交給系統(tǒng)的單獨(dú)的一個(gè)進(jìn)程肺孵。
重要:identifier 是configuration的唯一標(biāo)示匀借,不能為空或nil.
工作狀態(tài):
如果程序是被系統(tǒng)正常終止的和重新啟動(dòng),可以使用同一個(gè)identifier創(chuàng)建configuration和session平窘,并且能恢復(fù)終止時(shí)的傳輸狀態(tài)吓肋。
如果程序是被用戶在手動(dòng)退出的,session會(huì)取消所有的后臺(tái)任務(wù)瑰艘,屆時(shí)不能再喚醒a(bǔ)pplication是鬼,如果想要再次開始傳輸,必須用戶手動(dòng)開啟application紫新。
屬性介紹:
@property(readonly, copy) NSString *identifier
如果在后臺(tái)任務(wù)正在傳輸時(shí)程序退出均蜜,可以使用這個(gè)identifier在程序重新啟動(dòng)是創(chuàng)建一個(gè)新的configuration和session關(guān)聯(lián)之前傳輸。
@property(copy) NSDictionary *HTTPAdditionalHeaders
默認(rèn)為空芒率,NSURLRequest附件的請求頭囤耳。這個(gè)屬性會(huì)給所有使用該configuration的session生成的tasks中的NSURLRequest添加額外的請求頭。
重要:不要修改一下請求頭
Authorization
Connection
Host
WWW-Authenticate
如果這里邊添加的請求頭跟NSURLRequest中重復(fù)了,側(cè)優(yōu)先使用NSURLRequest中的頭充择。
例如?
configuration.HTTPAdditionalHeaders = @{
@"Accept": @"application/json",
@"Accept-Language": @"en",
@"User-Agent": @"iPhone" ?//告訴服務(wù)器是手機(jī)客戶端
};
@property NSURLRequestNetworkServiceType networkServiceType
指定網(wǎng)絡(luò)傳輸類型德玫。精切指出傳輸類型,可以讓系統(tǒng)快速響應(yīng)椎麦,提高傳輸質(zhì)量宰僧,延長電池壽命等。
enum{
NSURLNetworkServiceTypeDefault
=
0,
普通網(wǎng)絡(luò)傳輸观挎,默認(rèn)使用這個(gè)
NSURLNetworkServiceTypeVoIP
=
1,
網(wǎng)絡(luò)語音通信傳輸琴儿,只能在VoIP使用
NSURLNetworkServiceTypeVideo
=
2,影像傳輸
NSURLNetworkServiceTypeBackground
=
3,網(wǎng)絡(luò)后臺(tái)傳輸,優(yōu)先級(jí)不高時(shí)可使用键兜。對(duì)用戶不需要的網(wǎng)絡(luò)操作可使用
NSURLNetworkServiceTypeVoice
=
4
語音傳輸};typedef
NSUInteger
NSURLRequestNetworkServiceType;
@property BOOL allowsCellularAccess
是否使用蜂窩網(wǎng)絡(luò)凤类,默認(rèn)是yes.
@property NSTimeInterval timeoutIntervalForRequest
給request指定每次接收數(shù)據(jù)超時(shí)間隔,如果下一次接受新數(shù)據(jù)用時(shí)超過該值普气,則發(fā)送一個(gè)請求超時(shí)給該request谜疤。默認(rèn)為60s
@property NSTimeInterval timeoutIntervalForResource
給指定resource設(shè)定一個(gè)超時(shí)時(shí)間,resource需要在時(shí)間到達(dá)之前完成现诀。默認(rèn)是7天夷磕。
@property(copy) NSString *sharedContainerIdentifier
如果要為app的插件提供session,需要給這個(gè)值賦值
@property NSHTTPCookieAcceptPolicy HTTPCookieAcceptPolicy
默認(rèn)值是NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain仔沿,如果想更多的cookie控制坐桩,可以使用NSHTTPCookieAcceptPolicyNever,配合allHeaderFields 跟NSHTTPCookie中方法cookiesWithResponseHeaderFields:forURL:提取cookie封锉。
typedef
enum
{
NSHTTPCookieAcceptPolicyAlways,
NSHTTPCookieAcceptPolicyNever,
NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain}
NSHTTPCookieAcceptPolicy;
@property(retain) NSHTTPCookieStorage *HTTPCookieStorage
存儲(chǔ)cookie绵跷,清除存儲(chǔ),直接set為nil即可成福。
對(duì)于默認(rèn)和后臺(tái)的session碾局,使用sharedHTTPCookieStorage。
對(duì)于短暫的session奴艾,cookie僅僅儲(chǔ)存到內(nèi)存净当,session失效時(shí)會(huì)自動(dòng)清除。
@property BOOL HTTPShouldSetCookies
默認(rèn)為yes,是否提供來自shareCookieStorge的cookie蕴潦,如果想要自己提供cookie像啼,可以使用HTTPAdditionalHeaders來提供。
@property(retain) NSURLCredentialStorage *URLCredentialStorage
證書存儲(chǔ)潭苞,如果不使用忽冻,可set為nil.
默認(rèn)和后臺(tái)session,默認(rèn)使用的sharedCredentialStorage.
短暫的session使用一個(gè)私有存儲(chǔ)在內(nèi)存中此疹。session失效會(huì)自動(dòng)清除甚颂。
@property(retain) NSURLCache *URLCache
緩存NSURLRequest的response蜜猾。
默認(rèn)的configuration,默認(rèn)值的是sharedURLCache振诬。
后臺(tái)的configuration,默認(rèn)值是nil
短暫的configuration衍菱,默認(rèn)一個(gè)私有的cache于內(nèi)存赶么,session失效,cache自動(dòng)清除脊串。
@property NSURLRequestCachePolicy requestCachePolicy
緩存策略辫呻,默認(rèn)值是NSURLRequestUseProtocolCachePolicy
enum{
NSURLRequestUseProtocolCachePolicy
=
0,
NSURLRequestReloadIgnoringLocalCacheData
=
1,不理會(huì)cache
NSURLRequestReloadIgnoringLocalAndRemoteCacheData
=
4,
//
Unimplemented NSURLRequestReloadIgnoringCacheData
=
NSURLRequestReloadIgnoringLocalCacheData,
不理會(huì)cache
NSURLRequestReturnCacheDataElseLoad
=
2,返回cache,未命中則拉去遠(yuǎn)程數(shù)據(jù)
NSURLRequestReturnCacheDataDontLoad
=
3,拉去數(shù)據(jù)琼锋,未命中放闺,不做操作
NSURLRequestReloadRevalidatingCacheData
=
5
//
Unimplemented };typedef
NSUInteger
NSURLRequestCachePolicy;