NSURLSession
自 iOS 7 之後,NSURLSession 成為系統推薦使用的 HTTP 請求框架。在進行前台請求時,NSURLSession 與 NSURLConnection 差異不大;而對於後台請求,NSURLSession 更靈活的優勢便展露無遺。
1. NSURLSession 的類型
NSURLSession 類提供三種 Session 類型:
(1)Default 類型:提供前台請求相關方法,支援配置快取、身分憑證等。
(2)Ephemeral 類型:即時的請求類型,不使用快取、身分憑證等。
(3)Background 類型:後台類型,支援在後台完成請求任務。
2. NSURLSession 任務的類型
在 NSURLSession 中新增的請求任務支援三種類型:
(1)資料任務:使用 NSData 物件進行資料的發送與取得,一般用於短資料的任務。
(2)下載任務:從檔案下載資料,支援後台下載。
(3)上傳任務:以檔案的形式上傳資料,支援後台上傳。
3. 建立並配置 NSURLSession
透過 NSURLSessionConfiguration 類物件對 NSURLSession 進行配置與建立,範例程式碼如下:
//預設類型的
NSURLSessionConfiguration * defaultConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
//即時類型的
NSURLSessionConfiguration * ephemeralConfiguration = [NSURLSessionConfiguration ephemeralSessionConfiguration];
//後台類型的
NSURLSessionConfiguration * backgroundConfiguration = [NSURLSessionConfiguration backgroundSessionConfigurationWithIdentifier:@"SessionId"];
//建立並設定 session
NSURLSession * defaultSession = [NSURLSession sessionWithConfiguration:defaultConfiguration];
NSURLSession * ephemeralSession = [NSURLSession sessionWithConfiguration:ephemeralConfiguration];
NSURLSession * backgroundSession = [NSURLSession sessionWithConfiguration:backgroundConfiguration];NSURLSessionConfiguration 還可以配置快取、網路模式等參數。
4. 使用 NSURLSession 進行網路請求的兩種方式
NSURLSession 有兩種方式進行網路資料請求:一種是透過 block 取得網路資料,另一種是透過代理回調取得網路資料。使用 block 方式的請求程式碼如下:
//建立 session 配置物件
NSURLSessionConfiguration * defaultConfiguration = [NSURLSessionConfiguration defaultSessionConfiguration];
//建立請求物件
NSURLRequest * request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"https://www.baidu.com"]];
//建立 session 物件
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);
}
5. 進行後台下載任務
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 鍵使應用程式進入後台,NSURLSession 的相關代理方法將不再被回調,但下載任務依然在進行。當後台下載完成後會與 AppDelegate 互動,呼叫 AppDelegate 中的如下方法:
-(void)application:(UIApplication *)application handleEventsForBackgroundURLSession:(NSString *)identifier completionHandler:(void (^)())completionHandler{
NSLog(@"1111");
}之後應用程式在後台會呼叫 NSURLSession 代理的如下方法來通知下載結果:
//此方法無論成功失敗都會呼叫
-(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error{
NSLog(@"完成:error%@",error);
}
//此方法只有下載成功才會呼叫,檔案放在 location 位置
-(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location{
}最後會呼叫 NSURLSession 的如下方法:
-(void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session
{
NSLog(@"All tasks are finished");
}
Cookie
Cookie 是網站為了辨識終端身分,而儲存在本地的使用者憑證資訊。Cookie 中的欄位與意義由伺服器端定義。舉例來說,當使用者在某個網站登入後,伺服器會把 Cookie 資訊回傳給終端,終端將其保存;下次再次造訪同一網站時,終端會把已保存的 Cookie 一併送出,伺服器再根據 Cookie 是否有效,判斷該使用者能否自動登入。
iOS 中進行 Cookie 管理的兩個類:iOS 中 HTTP 網路請求的 Cookie 管理主要由兩個類負責,一個是 NSHTTPCookieStorage,另一個是 NSHTTPCookie。
1. NSHTTPCookieStorage
NSHTTPCookieStorage 採用單例設計模式,集中管理所有 HTTP 請求的 Cookie 資訊,常用方法如下:
//取得單例物件
+ (NSHTTPCookieStorage *)sharedHTTPCookieStorage;
//所有 Cookie 資料陣列,其中存放 NSHTTPCookie 物件
@property (nullable , readonly, copy) NSArray<NSHTTPCookie *> *cookies;
//手動設定一筆 Cookie 資料
- (void)setCookie:(NSHTTPCookie *)cookie;
//刪除某筆 Cookie 資訊
- (void)deleteCookie:(NSHTTPCookie *)cookie;
//取得某個特定 URL 的所有 Cookie 資料
- (nullable NSArray<NSHTTPCookie *> *)cookiesForURL:(NSURL *)URL;
//刪除某個時間之後的所有 Cookie 資訊,iOS8 之後可用
- (void)removeCookiesSinceDate:(NSDate *)date NS_AVAILABLE(10_10, 8_0);
//為某個特定的 URL 設定 Cookie
- (void)setCookies:(NSArray<NSHTTPCookie *> *)cookies forURL:(nullable NSURL *)URL mainDocumentURL:(nullable NSURL *)mainDocumentURL;
//Cookie 資料的接收協定
/*
列舉如下:
typedef NS_ENUM(NSUInteger, NSHTTPCookieAcceptPolicy) {
NSHTTPCookieAcceptPolicyAlways,//接收所有 Cookie 資訊
NSHTTPCookieAcceptPolicyNever,//不接收任何 Cookie 資訊
NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain//只接收主文件網域的 Cookie 資訊
};
*/
@property NSHTTPCookieAcceptPolicy cookieAcceptPolicy;系統中還有兩個通知與 Cookie 管理相關:
//Cookie 資料的接收協定改變時送出的通知
FOUNDATION_EXPORT NSString * const NSHTTPCookieManagerAcceptPolicyChangedNotification;
//所管理的 Cookie 資料發生變化時送出的通知
FOUNDATION_EXPORT NSString * const NSHTTPCookieManagerCookiesChangedNotification;
2. NSHTTPCookie
NSHTTPCookie 是具體的 HTTP 請求 Cookie 資料物件,其屬性與方法如下:
//下面兩個方法用於物件的建立與初始化,都是透過字典進行鍵值設定
- (nullable instancetype)initWithProperties:(NSDictionary<NSString *, id> *)properties;
+ (nullable NSHTTPCookie *)cookieWithProperties:(NSDictionary<NSString *, id> *)properties;
//回傳 Cookie 資料中可用於加入 HTTP 標頭欄位的字典
+ (NSDictionary<NSString *, NSString *> *)requestHeaderFieldsWithCookies:(NSArray<NSHTTPCookie *> *)cookies;
//從指定的回應標頭與 URL 位址中解析出 Cookie 資料
+ (NSArray<NSHTTPCookie *> *)cookiesWithResponseHeaderFields:(NSDictionary<NSString *, NSString *> *)headerFields forURL:(NSURL *)URL;
//Cookie 資料中的屬性字典
@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;
//是否只發送 HTTP 的服務
@property (readonly, getter=isHTTPOnly) BOOL HTTPOnly;
//回應的文件
@property (nullable, readonly, copy) NSString *comment;
//回應的文件 URL
@property (nullable, readonly, copy) NSURL *commentURL;
//服務連接埠列表
@property (nullable, readonly, copy) NSArray<NSNumber *> *portList;