基本組成
使用需要配合三個基本的對象類型,分別是:
NSURLSessionConfiguation
NSURLSession
NSURLSessionTask
NSURLSession類似于平日網絡交互時所謂的會話,對于NSURLSession,其本身并不會進行網絡數據傳輸,NSURLSession需要創建若干NSURLSessionTask來對應每次網絡數據傳輸
NSURLSession的類型
定義了三種
Default sessions behave similarly to other Foundation methods for downloading URLs. They use a persistent disk-based cache and store credentials in the user’s keychain.
Ephemeral sessions do not store any data to disk; all caches, credential stores, and so on are kept in RAM and tied to the session. Thus, when your app invalidates the session, they are purged automatically.
Background sessions are similar to default sessions, except that a separate process handles all data transfers. Background sessions have some additional limitations, described in Background Transfer Considerations.
Default Session 將cache以及credentials存儲于本地。
而Ephemeral Session 則對數據更加保密安全一些,它不會向本地存儲任何信息,所有的cache、credentials 等存在內存中并和Session綁定,當Session銷毀時,所有的相關信息也同時自動銷毀。
Background Session能夠使APP處于后臺時,數據繼續傳輸。其行為與default Session類似,但是所有的數據傳輸均有一個獨立的進程來管理(非本APP)。同時Background Session也有一些功能上的限制。
NSURLSessionConfiguration
NSURLSessionConfiguration 對象用于對 NSURLSession 對象進行初始化。NSURLSessionConfiguration 對以前 NSMutableURLRequest 所提供的網絡請求層的設置選項進行了擴充,提供給我們相當大的靈活性和控制權。從指定可用網絡,到 cookie,安全性,緩存策略,再到使用自定義協議,啟動事件的設置,以及用于移動設備優化的幾個新屬性,你會發現使用 NSURLSessionConfiguration 可以找到幾乎任何你想要進行配置的選項。
NSURLSession 在初始化時會把配置它的 NSURLSessionConfiguration 對象進行一次 copy,并保存到自己的 configuration 屬性中,而且這個屬性是只讀的。因此之后再修改最初配置 session 的那個 configuration 對象對于 session 是沒有影響的。也就是說,configuration 只在初始化時被讀取一次,之后都是不會變化的。
NSURLSessionConfiguration 的工廠方法
NSURLSessionConfiguration 有三個類工廠方法,這很好地說明了 NSURLSession 設計時所考慮的不同的使用場景。
+defaultSessionConfiguration 返回一個標準的 configuration,這個配置實際上與 NSURLConnection 的網絡堆棧(networking stack)是一樣的,具有相同的共享 NSHTTPCookieStorage,共享 NSURLCache 和共享 NSURLCredentialStorage。
+ephemeralSessionConfiguration 返回一個預設配置,這個配置中不會對緩存,Cookie 和證書進行持久性的存儲。這對于實現像秘密瀏覽這種功能來說是很理想的。
+backgroundSessionConfiguration:(NSString *)identifier 的獨特之處在于,它會創建一個后臺 session。后臺 session 不同于常規的,普通的 session,它甚至可以在應用程序掛起,退出或者崩潰的情況下運行上傳和下載任務。初始化時指定的標識符,被用于向任何可能在進程外恢復后臺傳輸的守護進程(daemon)提供上下文。
NSURLSessionTask
有三種類型的task
NSURLsessionTask 是一個抽象類,其下有 3 個實體子類可以直接使用:NSURLSessionDataTask
、NSURLSessionUploadTask
、NSURLSessionDownloadTask
。這 3 個子類封裝了現代程序三個最基本的網絡任務:獲取數據,比如 JSON 或者 XML,上傳文件和下載文件。
例子
Data task 可以通過 NSURL 或 NSURLRequest 創建(使用前者相當于是使用一個對于該 URL 進行標準 GET 請求的 NSURLRequest,這是一種快捷方法)
NSString *londonWeatherUrl = @"http://api.openweathermap.org/data/2.5/weather?q=London,uk" ;
NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:nil delegateQueue:[NSOperationQueue mainQueue]];
NSURLSessionDataTask *dataTask = [session dataTaskWithURL:[NSURL URLWithString:londonWeatherUrl] completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
LxDBAnyVar(data);
LxDBAnyVar(response);
}];
[dataTask resume];