NSURLSession
在iOS7之後,NSURLSession作為系統推薦使用的HTTP請求架構,在進行前台請求的情況下,NSURLSession與NSURLConnection並無太大差異,對於背景請求,NSURLSession更加靈活的優勢就將展現無遺。
1.NSURLSession集合的類型
NSURLSession類提供3中Session類型:
(1)Default類型:提供前台請求相關方法,支援配置緩衝,身份憑證等。
(2)Ephemeral類型:即時的請求類型,不使用緩衝,身份憑證等。
(3)Background:後台類型,支援在後台完成請求任務。
2.NSURLSession任務的類型
在NSURLSession中添加的請求任務支援3中類型:
(1)資料任務:使用NSData對象進行資料的發送和擷取,一般用於短資料的任務。
(2)下載任務:從檔案下載資料,支援後台下載。
(3)上傳任務:以檔案的形式上傳資料,支援後台上傳。
3.建立並配置NSURLSession:
通過NSURLSessionConfiguration類對象對NSURLSession進行配置與建立,建立和配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:@"http://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:@"http://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:@"http://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");
}
之後應用程式在後台會調用NSURLSesstion代理的如下方法來通知下載結果:
//此方法無論成功失敗都會調用
-(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error{
NSLog(@"完成:error%@",error);
}
//此方法只有下載成功才會調用 檔案放在location位置
-(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location{
}
最後將調用NSURLSesstion的如下方法:
-(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;
//刪除某個時間後的所有Cookie資訊 iOS8後可用
- (nullable NSArray<NSHTTPCookie *> *)cookiesForURL:(NSURL *)URL;
//擷取某個特定URL的所有Cookie資料
- (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;