從 iOS 7 起,NSURLSession 就是系統推薦的網路請求方案。前台請求時,它和 NSURLConnection 差異不大;但一旦涉及背景執行,NSURLSession 的優勢就非常明顯了。
(1)Default:一般請求,支援緩存、身份憑證等配置;
(2)Ephemeral:即時型,不落任何緩存與憑證,適合隱私情境;
(3)Background:背景型,App 被系統掛起後仍能繼續完成任務。
(1)Data Task:以 NSData 收發,適合短資料;
(2)Download Task:下載檔案,支援背景;
(3)Upload Task:以檔案形式上傳,支援背景。
配置由 NSURLSessionConfiguration 負責:
// 默認類型
NSURLSessionConfiguration *defaultConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
// 即時類型
NSURLSessionConfiguration *ephemeralConfiguration = [NSURLSessionConfiguration ephemeralSessionConfiguration];
// 背景類型(identifier 用於跨進程恢復任務)
NSURLSessionConfiguration *backgroundConfiguration =
[NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:@"SessionId"];
// 建立 session
NSURLSession *defaultSession = [NSURLSession sessionWithConfiguration:defaultConfiguration];
NSURLSession *ephemeralSession = [NSURLSession sessionWithConfiguration:ephemeralConfiguration];
NSURLSession *backgroundSession = [NSURLSession sessionWithConfiguration:backgroundConfiguration];
Configuration 還能配置緩存策略、允許的網路類型、超時時間、是否走蜂窩網路等,等於把整組請求的預設值集中在一處管理。
一種是 block 回調,寫法簡潔:
NSURLSessionConfiguration *defaultConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"https://www.baidu.com"]];
NSURLSession *defaultSession = [NSURLSession sessionWithConfiguration:defaultConfiguration];
NSURLSessionTask *task = [defaultSession dataTaskWithRequest:request
completionHandler:^(NSData * _Nullable data,
NSURLResponse * _Nullable response,
NSError * _Nullable error) {
NSLog(@"%@", data);
}];
[task resume];
另一種是代理回調,適合需要逐段處理資料或掌握進度的場景:
@interface ViewController () <NSURLSessionDataDelegate> @end
NSURLSessionConfiguration *defaultConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"https://www.baidu.com"]];
NSURLSession *defaultSession = [NSURLSession sessionWithConfiguration:defaultConfiguration
delegate:self
delegateQueue:[NSOperationQueue mainQueue]];
NSURLSessionTask *task = [defaultSession dataTaskWithRequest:request];
[task resume];
// 開始收到資料
-(void)URLSession:(NSURLSession *)session
dataTask:(NSURLSessionDataTask *)dataTask
didReceiveData:(NSData *)data{
NSLog(@"=======%@", data);
}
// 任務結束(不論成功失敗)
-(void)URLSession:(NSURLSession *)session
task:(NSURLSessionTask *)task
didCompleteWithError:(NSError *)error{
NSLog(@"完成:error%@", error);
}
有一點務必記住:不論用哪種方式,task 建立後都必須呼叫 resume 才會真正送出,忘了這步是新手最常見的困惑來源。
背景執行是 NSURLSession 存在的最大理由:
NSURLSessionConfiguration *backgroundConfiguration =
[NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:@"com.zyprosoft.backgroundsession"];
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"https://www.baidu.com"]];
NSURLSession *backgroundSession = [NSURLSession sessionWithConfiguration:backgroundConfiguration
delegate:self
delegateQueue:nil];
[[backgroundSession downloadTaskWithRequest:request] resume];
監聽下載進度:
- (void)URLSession:(NSURLSession *)session
downloadTask:(NSURLSessionDownloadTask *)downloadTask
didWriteData:(int64_t)bytesWritten
totalBytesWritten:(int64_t)totalBytesWritten
totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
{
NSLog(@"######");
}
按下 Home 鍵讓 App 進入背景後,NSURLSession 的代理方法會暫停回調,但下載本身並不會中斷。下載完成時,系統會先與 AppDelegate 交互:
-(void)application:(UIApplication *)application
handleEventsForBackgroundURLSession:(NSString *)identifier
completionHandler:(void (^)())completionHandler{
NSLog(@"1111");
}
接著回到 session 代理,通知下載結果:
// 不論成功失敗都會呼叫
-(void)URLSession:(NSURLSession *)session
task:(NSURLSessionTask *)task
didCompleteWithError:(NSError *)error{
NSLog(@"完成:error%@", error);
}
// 只有下載成功才會呼叫,檔案位於 location
-(void)URLSession:(NSURLSession *)session
downloadTask:(NSURLSessionDownloadTask *)downloadTask
didFinishDownloadingToURL:(NSURL *)location{
}
最後收尾:
-(void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session
{
NSLog(@"All tasks are finished");
}
實務上要留意兩點:location 是系統提供的暫存檔,必須在回調返回前搬到你自己的目錄,否則檔案會被清理;以及在最後那個回調裡呼叫 AppDelegate 傳來的 completionHandler,否則系統會判定你的 App 處理超時。
Cookie 是網站為了辨識終端身份而保存在本地的憑證。字段名稱與含義由服務端定義:使用者登入後,服務端把 Cookie 回傳給終端,終端保存起來;下次再訪問時自動帶上,服務端依此判斷能否免密登入。
單例設計,集中管理所有 HTTP 請求的 Cookie:
// 取得單例
+ (NSHTTPCookieStorage *)sharedHTTPCookieStorage;
// 全部 Cookie
@property (nullable, readonly, copy) NSArray<NSHTTPCookie *> *cookies;
// 手動新增一條
- (void)setCookie:(NSHTTPCookie *)cookie;
// 刪除某條
- (void)deleteCookie:(NSHTTPCookie *)cookie;
// 取得指定 URL 的 Cookie
- (nullable NSArray<NSHTTPCookie *> *)cookiesForURL:(NSURL *)URL;
// 刪除某時間之後的 Cookie(iOS 8 起)
- (void)removeCookiesSinceDate:(NSDate *)date NS_AVAILABLE(10_10, 8_0);
// 為指定 URL 批量設置
- (void)setCookies:(NSArray<NSHTTPCookie *> *)cookies
forURL:(nullable NSURL *)URL
mainDocumentURL:(nullable NSURL *)mainDocumentURL;
// 接收策略
/*
typedef NS_ENUM(NSUInteger, NSHTTPCookieAcceptPolicy) {
NSHTTPCookieAcceptPolicyAlways, // 全部接收
NSHTTPCookieAcceptPolicyNever, // 一律不接收
NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain // 只接收主域的
};
*/
@property NSHTTPCookieAcceptPolicy cookieAcceptPolicy;
兩個相關通知:
// 接收策略變更 FOUNDATION_EXPORT NSString * const NSHTTPCookieManagerAcceptPolicyChangedNotification; // Cookie 內容變更 FOUNDATION_EXPORT NSString * const NSHTTPCookieManagerCookiesChangedNotification;
具體的 Cookie 對象,可以從回應頭解析,也可以手動組裝:
// 以字典建立
- (nullable instancetype)initWithProperties:(NSDictionary<NSString *, id> *)properties;
+ (nullable NSHTTPCookie *)cookieWithProperties:(NSDictionary<NSString *, id> *)properties;
// 轉成可直接塞進請求頭的字典
+ (NSDictionary<NSString *, NSString *> *)requestHeaderFieldsWithCookies:(NSArray<NSHTTPCookie *> *)cookies;
// 從回應頭與 URL 解析出 Cookie
+ (NSArray<NSHTTPCookie *> *)cookiesWithResponseHeaderFields:(NSDictionary<NSString *, NSString *> *)headerFields
forURL:(NSURL *)URL;
// 常用只讀屬性
@property (nullable, readonly, copy) NSDictionary<NSString *, id> *properties;
@property (readonly) NSUInteger version;
@property (readonly, copy) NSString *name;
@property (readonly, copy) NSString *value;
@property (nullable, readonly, copy) NSDate *expiresDate;
@property (readonly, copy) NSString *domain;
@property (readonly, copy) NSString *path;
@property (readonly, getter=isSecure) BOOL secure;
@property (readonly, getter=isHTTPOnly) BOOL HTTPOnly;
@property (nullable, readonly, copy) NSString *comment;
@property (nullable, readonly, copy) NSURL *commentURL;
@property (nullable, readonly, copy) NSArray<NSNumber *> *portList;
實務上補充幾句:session 的 HTTPShouldHandleCookies 預設為 YES,系統會自動管理 Cookie,多數情況你不必手動碰 NSHTTPCookieStorage。只有需要跨接口共享登入態、或要手動清理某個域的憑證時,才需要直接操作它。另外,background session 的 Cookie 是獨立於 default session 的,若兩者需要共享登入狀態,記得把 configuration 的 HTTPCookieStorage 指向同一個 storage 對象。