NSURLSessionConfiguration API詳解(轉(zhuǎn)載)

一揍很、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;

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市缕坎,隨后出現(xiàn)的幾起案子怖侦,更是在濱河造成了極大的恐慌,老刑警劉巖谜叹,帶你破解...
    沈念sama閱讀 217,185評(píng)論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件匾寝,死亡現(xiàn)場離奇詭異,居然都是意外死亡荷腊,警方通過查閱死者的電腦和手機(jī)艳悔,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,652評(píng)論 3 393
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來女仰,“玉大人猜年,你說我怎么就攤上這事〖踩蹋” “怎么了乔外?”我有些...
    開封第一講書人閱讀 163,524評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長锭碳。 經(jīng)常有香客問我袁稽,道長,這世上最難降的妖魔是什么擒抛? 我笑而不...
    開封第一講書人閱讀 58,339評(píng)論 1 293
  • 正文 為了忘掉前任推汽,我火速辦了婚禮,結(jié)果婚禮上歧沪,老公的妹妹穿的比我還像新娘歹撒。我一直安慰自己,他們只是感情好诊胞,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,387評(píng)論 6 391
  • 文/花漫 我一把揭開白布暖夭。 她就那樣靜靜地躺著锹杈,像睡著了一般。 火紅的嫁衣襯著肌膚如雪迈着。 梳的紋絲不亂的頭發(fā)上竭望,一...
    開封第一講書人閱讀 51,287評(píng)論 1 301
  • 那天,我揣著相機(jī)與錄音裕菠,去河邊找鬼咬清。 笑死,一個(gè)胖子當(dāng)著我的面吹牛奴潘,可吹牛的內(nèi)容都是我干的旧烧。 我是一名探鬼主播,決...
    沈念sama閱讀 40,130評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼画髓,長吁一口氣:“原來是場噩夢啊……” “哼掘剪!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起奈虾,我...
    開封第一講書人閱讀 38,985評(píng)論 0 275
  • 序言:老撾萬榮一對(duì)情侶失蹤夺谁,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后愚墓,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體予权,經(jīng)...
    沈念sama閱讀 45,420評(píng)論 1 313
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,617評(píng)論 3 334
  • 正文 我和宋清朗相戀三年浪册,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了扫腺。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,779評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡村象,死狀恐怖笆环,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情厚者,我是刑警寧澤躁劣,帶...
    沈念sama閱讀 35,477評(píng)論 5 345
  • 正文 年R本政府宣布,位于F島的核電站库菲,受9級(jí)特大地震影響账忘,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜熙宇,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,088評(píng)論 3 328
  • 文/蒙蒙 一鳖擒、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧烫止,春花似錦蒋荚、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,716評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽惊奇。三九已至,卻和暖如春播赁,著一層夾襖步出監(jiān)牢的瞬間颂郎,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,857評(píng)論 1 269
  • 我被黑心中介騙來泰國打工行拢, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留祖秒,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 47,876評(píng)論 2 370
  • 正文 我出身青樓舟奠,卻偏偏與公主長得像,于是被迫代替她去往敵國和親房维。 傳聞我的和親對(duì)象是個(gè)殘疾皇子沼瘫,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,700評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容