[iOS-Foundation] NSURLSessionConfiguration

NSURLSessionConfiguration 定義了NSURLSession中網(wǎng)絡(luò)請求的行為和策略摔刁,如超時(shí)時(shí)間、緩存策略等栈虚。當(dāng)使用NSURLSessionConfiguration對(duì)象創(chuàng)建NSURLSession對(duì)象時(shí)嗜诀,會(huì)使用NSURLSessionConfiguration對(duì)象的一份拷貝,而之后對(duì)原NSURLSessionConfiguration對(duì)象的修改則不會(huì)影響NSURLSession對(duì)象妨蛹。若要修改則只能用更改后的NSURLSessionConfiguration對(duì)象重新創(chuàng)建新的NSURLSession對(duì)象。需要注意的是晴竞,NSURLSessionConfiguration中的某些設(shè)置可能會(huì)被NSURLSessionTask的 request 覆蓋蛙卤。

普通配置項(xiàng)

  • identifier,用于唯一標(biāo)識(shí)一個(gè)后臺(tái)下載的 session噩死,當(dāng)系統(tǒng)重啟被自動(dòng)關(guān)閉的應(yīng)用時(shí)颤难,可以通過這個(gè)標(biāo)識(shí)符,重新創(chuàng)建 configuration 和 session 對(duì)象來恢復(fù)中斷的下載已维。
  • HTTPAdditionalHeaders行嗤,一個(gè) dictionary,包含了需要額外添加到 session 中所有 request 的 header垛耳,如User-Agent栅屏。不應(yīng)添加
    AuthorizationConnection堂鲜、HostWWW-Authenticate既琴。如果 request 中已存在某一 header,則使用 request 中的值泡嘴,該 dictionary 默認(rèn)為空甫恩。
  • networkServiceTypeNSURLRequestNetworkServiceType類型酌予,network service type 影響著操作系統(tǒng)對(duì)于網(wǎng)絡(luò)傳輸?shù)膬?yōu)先級(jí)排列磺箕,進(jìn)而影響系統(tǒng)電量、性能的消耗抛虫。默認(rèn)值是NSURLNetworkServiceTypeDefault松靡。
  • allowsCellularAccess,布爾值建椰,指明在移動(dòng)網(wǎng)絡(luò)下是否可發(fā)起請求雕欺。
  • timeoutIntervalForRequest,請求的超時(shí)時(shí)間棉姐,默認(rèn)值為60秒屠列。
  • timeoutIntervalForResource,所有資源下載或上傳完成的超時(shí)時(shí)間伞矩,中間請求失敗可重新請求笛洛,單位為秒,默認(rèn)時(shí)間為7天乃坤。
  • sharedContainerIdentifier苛让,用于應(yīng)用擴(kuò)展與應(yīng)用間的后臺(tái)會(huì)話的擴(kuò)展容器沟蔑。

HTTP cookie 相關(guān)配置項(xiàng)

  • HTTPCookieAcceptPolicy,接收 cookie 的策略狱杰,
    NSHTTPCookieAcceptPolicy類型瘦材,默認(rèn)值是
    NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain
  • HTTPCookieStorage,對(duì)于default 和 background session仿畸,該屬性值為NSHTTPCookieStorage的單例對(duì)象食棕,而 ephemeral session 的默認(rèn)值為一個(gè)私有的NSHTTPCookieStorage對(duì)象,只將 cookie 保存在內(nèi)存中颁湖,如果 session 不想保存 cookie宣蠕,可將該屬性設(shè)為 nil。
  • HTTPShouldSetCookies甥捺,布爾值抢蚀,指明請求時(shí)是否攜帶 cookie 信息。

安全相關(guān)配置項(xiàng)

  • TLSMaximumSupportedProtocol镰禾,SSLProtocol 類型皿曲,請求支持的最高 TLS 版本,默認(rèn)值是 kTLSProtocol12吴侦,即 TLS1.2屋休。
  • TLSMinimumSupportedProtocol,SSLProtocol 類型备韧,請求支持的最低 TLS 版本劫樟,默認(rèn)值是 kSSLProtocol3,即 SSL3.0织堂。
  • URLCredentialStorage叠艳,管理需要驗(yàn)證的請求證書。

緩存策略配置項(xiàng)

  • URLCache易阳,用于保存緩存響應(yīng)的NSURLCache對(duì)象附较,default session 默認(rèn)使用NSURLCache的單例對(duì)象,background session 的默認(rèn)值為 nil潦俺,而 ephemeral session 的默認(rèn)值是一個(gè)私有的NSURLCache對(duì)象拒课,數(shù)據(jù)只保存在內(nèi)存中。如果不想使用緩存事示,可直接設(shè)置該值為 nil早像。
  • requestCachePolicy,枚舉類型NSURLRequestCachePolicy很魂,指明了請求使用緩存響應(yīng)的策略扎酷。
// 默認(rèn)值,使用協(xié)議本身的緩存邏輯遏匆。
NSURLRequestUseProtocolCachePolicy
// 不使用現(xiàn)有緩存法挨,數(shù)據(jù)需要從原始地址加載。
NSURLRequestReloadIgnoringLocalCacheData
// 無論緩存是否過期幅聘,先使用本地緩存數(shù)據(jù)凡纳。如果緩存中沒有請求所對(duì)應(yīng)的數(shù)據(jù),那么從原始地址加載數(shù)據(jù)帝蒿。
NSURLRequestReturnCacheDataElseLoad
// 無論緩存是否過期荐糜,先使用本地緩存數(shù)據(jù)。如果緩存中沒有請求所對(duì)應(yīng)的數(shù)據(jù)葛超,那么放棄從原始地址加載數(shù)據(jù)暴氏,請求視為失敗。
NSURLRequestReturnCacheDataDontLoad

后臺(tái)下載配置項(xiàng)

  • sessionSendsLaunchEvents绣张,布爾值答渔,說明在 session task 完成或者需要驗(yàn)證時(shí),是否在后臺(tái)運(yùn)行應(yīng)用侥涵。當(dāng)設(shè)為 YES 時(shí)沼撕,系統(tǒng)會(huì)自動(dòng)啟動(dòng)或運(yùn)行應(yīng)用,并調(diào)用 AppDelegate 中的方法
    application:handleEventsForBackgroundURLSession:completionHandler:芜飘,通過參數(shù)提供上述提到的唯一標(biāo)識(shí)后臺(tái)下載 session 的 identifier务豺。
  • discretionary,布爾值嗦明,說明在下載時(shí)是否由系統(tǒng)統(tǒng)一安排資源笼沥。

自定義協(xié)議配置項(xiàng)

  • protocolClasses,由自定義實(shí)現(xiàn)的NSURLProtocol子類的 Class 對(duì)象組成的數(shù)組娶牌,配置了 session 支持的自定義協(xié)議奔浅。

HTTP相關(guān)配置項(xiàng)

  • HTTPMaximumConnectionsPerHost,session 內(nèi)一個(gè)域名的最大同時(shí)連接數(shù)裙戏。
  • HTTPShouldUsePipelining乘凸,布爾值,說明 session 內(nèi)的 task 是否使用 HTTP pipelining累榜。
  • connectionProxyDictionary营勤,字典類型,保存了連接代理的相關(guān)信息壹罚,默認(rèn)為 NULL葛作。

內(nèi)置的配置對(duì)象

通過類方法,NSURLSessionConfiguration提供了適用于不同情況的配置對(duì)象猖凛,它們的一些配置屬性設(shè)置了不同的默認(rèn)值赂蠢。

  • + defaultSessionConfiguration,默認(rèn)的配置對(duì)象辨泳,持久化存儲(chǔ)緩存虱岂,證書玖院,cookie。
  • + ephemeralSessionConfiguration第岖,不持久化存儲(chǔ)緩存难菌,證書,cookie的配置蔑滓。所有相關(guān)內(nèi)容只保存在內(nèi)存中郊酒,當(dāng) session 失效或應(yīng)用終止,所有內(nèi)容被清空键袱。該配置可提高私密性燎窘,因?yàn)椴粫?huì)向硬盤上寫入數(shù)據(jù)。
  • + backgroundSessionConfigurationWithIdentifier:蹄咖,適用于在后臺(tái)上傳和下載文件的網(wǎng)絡(luò)請求褐健。當(dāng)應(yīng)用被系統(tǒng)終止并重啟,傳入的參數(shù) identifier 可用來重新創(chuàng)建配置和 session 對(duì)象比藻,以便恢復(fù)中斷的下載任務(wù)铝量。如果是用戶主動(dòng)終止程序,則不會(huì)有上述行為银亲。
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末慢叨,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子务蝠,更是在濱河造成了極大的恐慌拍谐,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,311評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件馏段,死亡現(xiàn)場離奇詭異轩拨,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)院喜,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,339評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門亡蓉,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人喷舀,你說我怎么就攤上這事砍濒。” “怎么了硫麻?”我有些...
    開封第一講書人閱讀 152,671評(píng)論 0 342
  • 文/不壞的土叔 我叫張陵爸邢,是天一觀的道長。 經(jīng)常有香客問我拿愧,道長杠河,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 55,252評(píng)論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮券敌,結(jié)果婚禮上唾戚,老公的妹妹穿的比我還像新娘。我一直安慰自己陪白,他們只是感情好颈走,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,253評(píng)論 5 371
  • 文/花漫 我一把揭開白布膳灶。 她就那樣靜靜地躺著咱士,像睡著了一般。 火紅的嫁衣襯著肌膚如雪轧钓。 梳的紋絲不亂的頭發(fā)上序厉,一...
    開封第一講書人閱讀 49,031評(píng)論 1 285
  • 那天,我揣著相機(jī)與錄音毕箍,去河邊找鬼弛房。 笑死,一個(gè)胖子當(dāng)著我的面吹牛而柑,可吹牛的內(nèi)容都是我干的文捶。 我是一名探鬼主播,決...
    沈念sama閱讀 38,340評(píng)論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼媒咳,長吁一口氣:“原來是場噩夢啊……” “哼粹排!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起涩澡,我...
    開封第一講書人閱讀 36,973評(píng)論 0 259
  • 序言:老撾萬榮一對(duì)情侶失蹤顽耳,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后妙同,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體射富,經(jīng)...
    沈念sama閱讀 43,466評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,937評(píng)論 2 323
  • 正文 我和宋清朗相戀三年粥帚,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了胰耗。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,039評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡芒涡,死狀恐怖柴灯,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情拖陆,我是刑警寧澤弛槐,帶...
    沈念sama閱讀 33,701評(píng)論 4 323
  • 正文 年R本政府宣布,位于F島的核電站依啰,受9級(jí)特大地震影響乎串,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,254評(píng)論 3 307
  • 文/蒙蒙 一叹誉、第九天 我趴在偏房一處隱蔽的房頂上張望鸯两。 院中可真熱鬧,春花似錦长豁、人聲如沸钧唐。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,259評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽钝侠。三九已至,卻和暖如春酸舍,著一層夾襖步出監(jiān)牢的瞬間帅韧,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評(píng)論 1 262
  • 我被黑心中介騙來泰國打工啃勉, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留忽舟,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,497評(píng)論 2 354
  • 正文 我出身青樓淮阐,卻偏偏與公主長得像叮阅,于是被迫代替她去往敵國和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子泣特,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,786評(píng)論 2 345

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