iOS開發網絡篇—發送GET和POST請求（使用NSURLSession）

iOS開發網絡篇—發送GET和POST請求（使用NSURLSession）

說明：

　　1）該文主要介紹如何使用NSURLSession來發送GET請求和POST請求

　　2）本文將不再講解NSURLConnection的使用，如有需要了解NSURLConnection如何發送請求。

　　　　詳細信息，請參考：http://www.cnblogs.com/wendingding/p/3813706.html

　　3）本文示例代碼發送的請求均為http請求，已經對info.plist文件進行配置。

　　　　如何配置，請參考：https://github.com/HanGangAndHanMeimei/iOS9AdaptationTips

　　4）本文示例代碼，可以在下面的地址獲取：

　　　　https://github.com/HanGangAndHanMeimei/Code

一、簡單說明

　　在iOS9.0之后，以前使用的NSURLConnection過期，蘋果推薦使用NSURLSession來替換NSURLConnection完成網路請求相關操作。

　　NSURLSession的使用非常簡單，先根據會話對象創建一個請求Task，然后執行該Task即可。

　　NSURLSessionTask本身是一個抽象類，在使用的時候，通常是根據具體的需求使用它的幾個子類。關系如下：

　　

二、發送GET請求

　　使用NSURLSession發送GET請求的方法和NSURLConnection類似，整個過程如下：

　　　　1）確定請求路徑（一般由公司的后台開發人員以接口文檔的方式提供），GET請求參數直接跟在URL后面

　　　　2）創建請求對象（默認包含了請求頭和請求方法【GET】），此步驟可以省略

　　　　3）創建會話對象（NSURLSession）

　　　　4）根據會話對象創建請求任務（NSURLSessionDataTask）

　　　　5）執行Task

　　　　6）當得到服務器返回的響應后，解析數據（XML|JSON|HTTP）

　　示例代碼：

-(void)get1
{
    //對請求路徑的說明
    //http://120.25.226.186:32812/login?username=520it&pwd=520&type=JSON
    //協議頭+主機地址+接口名稱+？+參數1&參數2&參數3
    //協議頭(http://)+主機地址(120.25.226.186:32812)+接口名稱(login)+？+參數1(username=520it)&參數2(pwd=520)&參數3(type=JSON)
    //GET請求，直接把請求參數跟在URL的后面以？隔開，多個參數之間以&符號拼接
    
    //1.確定請求路徑
    NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"];
    
    //2.創建請求對象
    //請求對象內部默認已經包含了請求頭和請求方法（GET）
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    
    //3.獲得會話對象
    NSURLSession *session = [NSURLSession sharedSession];
      
    //4.根據會話對象創建一個Task(發送請求）
    /*
     第一個參數：請求對象
     第二個參數：completionHandler回調（請求完成【成功|失敗】的回調）
               data：響應體信息（期望的數據）
               response：響應頭信息，主要是對服務器端的描述
               error：錯誤信息，如果請求失敗，則error有值
     */
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        
        if (error == nil) {
            //6.解析服務器返回的數據
            //說明：（此處返回的數據是JSON格式的，因此使用NSJSONSerialization進行反序列化處理）
            NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];
            
            NSLog(@"%@",dict);
        }
    }];
    
    //5.執行任務
    [dataTask resume];
}

-(void)get2
{
    //1.確定請求路徑
    NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"];
    
    //2.獲得會話對象
    NSURLSession *session = [NSURLSession sharedSession];
    
    //3.根據會話對象創建一個Task(發送請求）
    /*
     第一個參數：請求路徑
     第二個參數：completionHandler回調（請求完成【成功|失敗】的回調）
               data：響應體信息（期望的數據）
               response：響應頭信息，主要是對服務器端的描述
               error：錯誤信息，如果請求失敗，則error有值
     注意：
        1）該方法內部會自動將請求路徑包裝成一個請求對象，該請求對象默認包含了請求頭信息和請求方法（GET）
        2）如果要發送的是POST請求，則不能使用該方法
     */
    NSURLSessionDataTask *dataTask = [session dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        
        //5.解析數據
        NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];
        NSLog(@"%@",dict);
        
    }];
    
    //4.執行任務
    [dataTask resume];
}

　　執行結果：

　　

　　此處打印的值是一個字典，字典中success這個key對應的value打印出來為Unicode編碼的，如果想輸出中文，可以為NSDictionary提供一個分類，重寫系統中的方法。

　　

#import "NSDictionary+Log.h"

@implementation NSDictionary (Log)

-(NSString *)descriptionWithLocale:(id)locale indent:(NSUInteger)level
{
    //初始化可變字符串
    NSMutableString *string = [NSMutableString string];
    //拼接開頭[
    [string appendString:@"["];
    
    //拼接字典中所有的鍵值對
    [self enumerateKeysAndObjectsUsingBlock:^(id  _Nonnull key, id  _Nonnull obj, BOOL * _Nonnull stop) {
        [string appendFormat:@"%@:",key];
        [string appendFormat:@"%@",obj];
    }];
    
    //拼接結尾]
    [string appendString:@"]"];
    
    return string;
}

@end

　　執行結果：

　　

三、發送POST請求

　　使用NSURLSession發送POST請求的方法和NSURLConnection類似，整個過程如下：

　　　　1）確定請求路徑（一般由公司的后台開發人員以接口文檔的方式提供）

　　　　2）創建可變的請求對象（因為需要修改），此步驟不可以省略

　　　　3）修改請求方法為POST

　　　　4）設置請求體，把參數轉換為二進制數據並設置請求體

　　　　5）創建會話對象（NSURLSession）

　　　　6）根據會話對象創建請求任務（NSURLSessionDataTask）

　　　　7）執行Task

　　　　8）當得到服務器返回的響應后，解析數據（XML|JSON|HTTP）

　　示例代碼：

-(void)post
{
    //對請求路徑的說明
    //http://120.25.226.186:32812/login
    //協議頭+主機地址+接口名稱
    //協議頭(http://)+主機地址(120.25.226.186:32812)+接口名稱(login)
    //POST請求需要修改請求方法為POST，並把參數轉換為二進制數據設置為請求體
    
    //1.創建會話對象
    NSURLSession *session = [NSURLSession sharedSession];
    
    //2.根據會話對象創建task
    NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login"];
    
    //3.創建可變的請求對象
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    
    //4.修改請求方法為POST
    request.HTTPMethod = @"POST";
    
    //5.設置請求體
    request.HTTPBody = [@"username=520it&pwd=520it&type=JSON" dataUsingEncoding:NSUTF8StringEncoding];
    
    //6.根據會話對象創建一個Task(發送請求）
    /*
     第一個參數：請求對象
     第二個參數：completionHandler回調（請求完成【成功|失敗】的回調）
                data：響應體信息（期望的數據）
                response：響應頭信息，主要是對服務器端的描述
                error：錯誤信息，如果請求失敗，則error有值
     */
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        
        //8.解析數據
        NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];
        NSLog(@"%@",dict);
        
    }];
    
    //7.執行任務
    [dataTask resume];
}

四、NSURLSession代理方法簡單介紹

　　有的時候，我們可能需要監聽網絡請求的過程（如下載文件需監聽文件下載進度），那么就需要用到代理方法。

　　接下來通過代碼簡單說明NSURLSession中普通網絡請求會涉及代理方法的使用

#import "ViewController.h"

@interface ViewController ()<NSURLSessionDataDelegate>
@property (nonatomic, strong) NSMutableData *responseData;
@end

@implementation ViewController

-(NSMutableData *)responseData
{
    if (_responseData == nil) {
        _responseData = [NSMutableData data];
    }
    return _responseData;
}

//當點擊控制器View的時候會調用該方法
-(void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
{
    [self delegateTest];
}

//發送請求，代理方法
-(void)delegateTest
{
    //1.確定請求路徑
    NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"];
    
    //2.創建請求對象
    //請求對象內部默認已經包含了請求頭和請求方法（GET）
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    
    //3.獲得會話對象,並設置代理
    /*
     第一個參數：會話對象的配置信息defaultSessionConfiguration 表示默認配置
     第二個參數：誰成為代理，此處為控制器本身即self
     第三個參數：隊列，該隊列決定代理方法在哪個線程中調用，可以傳主隊列|非主隊列
     [NSOperationQueue mainQueue]   主隊列：   代理方法在主線程中調用
     [[NSOperationQueue alloc]init] 非主隊列： 代理方法在子線程中調用
     */
    NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];
    
    //4.根據會話對象創建一個Task(發送請求）
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request];
    
    //5.執行任務
    [dataTask resume];
}

//1.接收到服務器響應的時候調用該方法
-(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler
{
    //在該方法中可以得到響應頭信息，即response
    NSLog(@"didReceiveResponse--%@",[NSThread currentThread]);
    
    //注意：需要使用completionHandler回調告訴系統應該如何處理服務器返回的數據
    //默認是取消的
    /*
        NSURLSessionResponseCancel = 0,        默認的處理方式，取消
        NSURLSessionResponseAllow = 1,         接收服務器返回的數據
        NSURLSessionResponseBecomeDownload = 2,變成一個下載請求
        NSURLSessionResponseBecomeStream        變成一個流
     */
    
    completionHandler(NSURLSessionResponseAllow);
}

//2.接收到服務器返回數據的時候會調用該方法，如果數據較大那么該方法可能會調用多次
-(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
{
    NSLog(@"didReceiveData--%@",[NSThread currentThread]);
    
    //拼接服務器返回的數據
    [self.responseData appendData:data];
}

//3.當請求完成(成功|失敗)的時候會調用該方法，如果請求失敗，則error有值
-(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
    NSLog(@"didCompleteWithError--%@",[NSThread currentThread]);
    
    if(error == nil)
    {
        //解析數據,JSON解析請參考http://www.cnblogs.com/wendingding/p/3815303.html
        NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:self.responseData options:kNilOptions error:nil];
        NSLog(@"%@",dict);
    }
}
@end

　　代碼執行結果：