您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 網路層中的 NSURLSession 與 Cookie 機制詳解

編輯:iOS 相關教學

一、NSURLSession

從 iOS 7 起,NSURLSession 就是系統推薦的網路請求方案。前台請求時,它和 NSURLConnection 差異不大;但一旦涉及背景執行,NSURLSession 的優勢就非常明顯了。

1. 三種 Session 類型

(1)Default:一般請求,支援緩存、身份憑證等配置;
(2)Ephemeral:即時型,不落任何緩存與憑證,適合隱私情境;
(3)Background:背景型,App 被系統掛起後仍能繼續完成任務。

2. 三種任務類型

(1)Data Task:以 NSData 收發,適合短資料;
(2)Download Task:下載檔案,支援背景;
(3)Upload Task:以檔案形式上傳,支援背景。

3. 建立並配置

配置由 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 還能配置緩存策略、允許的網路類型、超時時間、是否走蜂窩網路等,等於把整組請求的預設值集中在一處管理。

4. 兩種取回資料的方式

一種是 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 才會真正送出,忘了這步是新手最常見的困惑來源。

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 鍵讓 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 是網站為了辨識終端身份而保存在本地的憑證。字段名稱與含義由服務端定義:使用者登入後,服務端把 Cookie 回傳給終端,終端保存起來;下次再訪問時自動帶上,服務端依此判斷能否免密登入。

1. NSHTTPCookieStorage

單例設計,集中管理所有 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;

2. NSHTTPCookie

具體的 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 對象。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved