配置物件的重要性
NSURLSessionConfiguration 定義了 NSURLSession 上傳與下載時的行為與策略。建立工作階段前,先建立並設定好配置物件,是確保網路行為符合預期的第一步。
需要特別注意:NSURLSession 會複製配置內容。一旦 session 建立完成,後續修改原本的 configuration 物件,通常不會影響既有 session。若要套用新的策略,必須重新建立 session。
三種常見配置
defaultSessionConfiguration
使用系統預設行為,通常會搭配磁碟快取、Cookie 儲存與憑證儲存。適合一般需要快取與持久狀態的請求。
ephemeralSessionConfiguration
臨時工作階段不會把快取、Cookie 或憑證持久化到磁碟,適合隱私性較高的情境,例如瀏覽器模式或一次性資料傳輸。
backgroundSessionConfigurationWithIdentifier
後台工作階段可讓上傳與下載在應用被掛起或終止後仍由系統繼續處理。identifier 是唯一識別值,不能用於空字串或 nil。
常用屬性
- identifier:後台工作階段的唯一標識
- HTTPAdditionalHeaders:所有請求共用的自訂標頭
- networkServiceType:提示系統網路服務類型,例如背景預讀
- allowsCellularAccess:是否允許使用蜂窩網路
- timeoutIntervalForRequest:等待資料的請求逾時時間
- timeoutIntervalForResource:單一資源的整體逾時時間
- sharedContainerIdentifier:後台工作階段可存取的共享容器
- HTTPCookieAcceptPolicy:Cookie 接受策略
- HTTPCookieStorage:Cookie 儲存物件
- HTTPShouldSetCookies:是否自動附加 Cookie
- TLSMaximumSupportedProtocol:最大 TLS 版本
- TLSMinimumSupportedProtocol:最小 TLS 版本
- URLCredentialStorage:憑證儲存物件
- URLCache:請求快取物件
- requestCachePolicy:快取使用策略
- sessionSendsLaunchEvents:後台任務完成時是否喚醒應用
- discretionary:是否允許系統依最佳效能安排後台傳輸
- protocolClasses:自訂 URL Protocol 子類陣列
- HTTPMaximumConnectionsPerHost:單一主機最大同時連線數
- HTTPShouldUsePipelining:是否使用 HTTP Pipelining
- connectionProxyDictionary:代理設定字典
請求策略與工作階段策略的關係
某些由 NSURLRequest 指定的策略,可能被工作階段配置覆寫。一般來說,若 request 的設定較寬鬆,而 session 設定較嚴格,最終仍會以 session 的限制為準。例如 session 不允許蜂窩網路時,單一 request 無法自行開啟。
後台傳輸的注意事項
使用後台工作階段時,若應用因系統正常終止而重新啟動,可透過相同 identifier 重新建立 session,並接續處理未完成任務。但若使用者從多工畫面手動結束應用,系統通常會取消後台任務,且不會自動重啟應用。