iOS-網絡編程AFNetworking使用

來源：互聯網轉載時間：2024-01-29 07:43:50

一. AFNetworking簡單介紹

通過前面學習的HTTP協議的基本知識,GET/POST請求的區別,NSURLConnection 和 NSURLSession的使用,已經基本了解了網絡請求的方法,但是相對使用比較麻煩,AFNetworking是對NSURLConnection 和 NSURLSession的封裝,使網絡請求更加簡單輕松,是一款非常有用的第三方框架。AFNetworking3.0以后移除了對NSURLConnection的支持。看一下AFNetworking 歷史版本以及框架

AFNetworking版本更新

AFNetworking框架

這些在GitHub上都可以看到,可以去GitHub上查看。

二. AFNetworking使用

1. GET請求

    AFHTTPSessionManager *manager =[AFHTTPSessionManager manager];    NSDictionary *dict = @{        @"username":@"520it",        @"pwd":@"520it"        };    // parameters 參數字典    [manager GET:@"http://120.25.226.186:32812/login" parameters:dict progress:^(NSProgress * _Nonnull downloadProgress) {        //進度        //進度    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseobject) {        // task 我們可以通過task拿到響應頭        // responseObject:請求成功返回的響應結果(AFN內部已經把響應體轉換為OC對象,通常是字典或數組)    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {        // error 錯誤信息    }];

2. POST請求

    AFHTTPSessionManager *manager =[AFHTTPSessionManager manager];    NSDictionary *dict = @{                           @"username":@"520it",                           @"pwd":@"520it"                           };    [manager POST:@"http://120.25.226.186:32812/login" parameters:dict progress:^(NSProgress * _Nonnull downloadProgress) {        // 進度    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {        // 請求成功    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {        // 請求失敗    }];

注意:我們發現GET和POST請求一模一樣,僅僅換了一個名字,GET請求也可以將參數放在字典中,也可以將參數拼接在url之后parameters傳nil。另外不需要開啟Task,因為AFN內部已經幫我們開啟了 另外:AFN默認會把服務器返回給我們的數據當做是JSNO數據,并且AFN內部已經把響應體JSON數據轉換為OC對象,通常是字典或數組。 那么如果服務器返回的XML呢?這時我們需要自己設置AFN解析方式

manager.responseSerializer = [AFXMLParserResponseSerializer serializer];

返回的是NSXMLParser,需要我們自己解析

如果返回的數據既不是JSON也不是XML那么需要設置

manager.responseSerializer = [AFHTTPResponseSerializer serializer];

AFN默認接收的ContentTypes 有以下三種

ContentType

如果服務器返回的ContentType不是這三種中的一種,我們就需要設置

manager.responseSerializer.acceptableContentTypes = [NSSet setWithObject:@"text/html"];

也可以直接在AFN源碼中添加(不建議使用,這種方式比較隱蔽,當更新過AFN之后這里會還原,出現問題比較難找)

直接添加即可

3. 文件下載

    // 1.創建一個管理者    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];    // 2. 創建請求對象    NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/resources/images/minion_03.png"];    NSURLRequest *request =[NSURLRequest requestWithURL:url];    // 3. 下載文件    NSURLSessionDownloadTask *downloadTask = [manager downloadTaskWithRequest:request progress:^(NSProgress * _Nonnull downloadProgress) {    // downloadProgress.completedUnitCount 當前下載大小    // downloadProgress.totalUnitCount 總大小    NSLog(@"%f", 1.0 * downloadProgress.completedUnitCount / downloadProgress.totalUnitCount);    } destination:^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response) {        // targetPath  臨時存儲地址        NSLog(@"targetPath:%@",targetPath);        NSString *path =[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];        NSString *filePath = [path stringByAppendingPathComponent:response.suggestedFilename];        NSURL *url = [NSURL fileURLWithPath:filePath];        NSLog(@"path:%@",filePath);        // 返回url 我們想要存儲的地址        // response 響應頭        return url;    } completionHandler:^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error) {        // 下載完成之后調用        // response 響應頭        // filePath 下載存儲地址        NSLog(@"filePath:%@",filePath);    }];    // 需要手動開啟    [downloadTask resume];

注意: 1. 下載文件需要獲取NSURLSessionDownloadTask對象手動開啟 2. 第一個block塊:downloadProgress 有兩個屬性completedUnitCount(已經下載文件大小)、totalUnitCount(文件總大小)。 3. 第二個block塊:需要返回一個url,表示想要將文件存儲的地方。targetPath:表示臨時存儲地址在tmp臨時文件中。response:響應頭可以拿到一些文件信息 4. 第三個block塊:下載完成之后調用。response:響應頭。filePath:文件存儲地址,與第二個block塊中返回的url是一個地址

4. 文件上傳

關于文件上傳使用AFN就簡單多了,也不需要我們去拼接請求體和請求文件參數啦,AFN內部已經幫我們拼接好了 方法一:formData 添加data形式數據

    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];    NSString *url =@"http://120.25.226.186:32812/upload";    [manager POST:url parameters:nil constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {        // formData 將要上傳的數據        UIImage *image =[UIImage imageNamed:@"123"];        NSData *data =UIImagePNGRepresentation(image);        // 方法一        /**           data:上傳文件二進制數據          name:接口的名字          fileName:文件上傳到服務器之后叫什么名字          mineType:上傳文件的類型,可以上傳任意二進制mineType.         */        [formData appendPartWithFileData:data name:@"file" fileName:@"123.png" mimeType:@"image/png"];        // 方法二        /**         data:上傳文件二進制數據         name:接口的名字         這種方法內部會將文件名當做上傳到服務器之后的名字,并自動獲取其類型         */        [formData appendPartWithFormData:data name:@"file"];    } progress:^(NSProgress * _Nonnull uploadProgress) {        // 上傳進度    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {        // 上傳成功        NSLog(@"上傳成功");    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {        // 上傳失敗        NSLog(@"上傳失敗");    }];

方法二:formData直接添加url

    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];    NSString *url =@"http://120.25.226.186:32812/upload";    [manager POST:url parameters:nil constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {        // formData 將要上傳的數據        // 直接傳URL        NSURL *url =[NSURL fileURLWithPath:@"/Users/yangboxing/Desktop/Snip20160905_7.png"];        // 方法一        [formData appendPartWithFileURL:url name:@"file" fileName:@"hhaha.png" mimeType:@"image/png" error:nil];        // 方法二        /**          這個方法會自動截取url最后一塊的文件名作為上傳到服務器的文件名          也會自動獲取mimeType,如果沒有辦法獲取mimeType 就使用@"application/octet-stream" 表示任意的二進制數據 ,當我們不在意文件類型的時候 也可以用這個。         */        [formData appendPartWithFileURL:url name:@"file" error:nil];    } progress:^(NSProgress * _Nonnull uploadProgress) {        // 上傳進度    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {        // 上傳成功        NSLog(@"上傳成功");    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {        // 上傳失敗        NSLog(@"上傳失敗");    }];

注意: mimeType表示文件的類型,關于mimeType類型可以自行百度,我們也可以通過發送請求獲取mineType

// 通過發送請求獲取mimeType-(NSString *)connectSync:(NSString *)path{    //1.確定請求路徑    NSURL *url = [NSURL fileURLWithPath:path];    //2.創建可變的請求對象    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];    NSHTTPURLResponse *res = nil;    [NSURLConnection sendSynchronousRequest:request returningResponse:&res error:nil];    NSLog(@"%@",res.MIMEType);    return res.MIMEType;}

我們通過[formData appendPartWithFileURL:url name:@"file" error:nil];來看看AFN是如何獲取mimeType的

文件名稱和mimeType獲取

進入方法內部

mimeType獲取

因此以后我們要獲取mimeType的時候也可以直接從AFN中復制拿去用嘍。

5. AFN網絡狀態的檢測

使用AFN進行網絡狀態的檢測非常簡單,并且可以持續監聽網絡狀態,每當網絡狀態發生改變的時候,都會調用setReachabilityStatusChangeBlock方法

    AFNetworkReachabilityManager *manager = [AFNetworkReachabilityManager sharedManager];    /*    AFNetworkReachabilityStatusUnknown          = -1, 未知    AFNetworkReachabilityStatusNotReachable     = 0,  沒有網絡    AFNetworkReachabilityStatusReachableViaWWAN = 1,  蜂窩流量    AFNetworkReachabilityStatusReachableViaWiFi = 2,  無線    */    // 監聽網絡狀態的變化    [manager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {        switch (status) {            case AFNetworkReachabilityStatusUnknown:                NSLog(@"未知");                break;            case AFNetworkReachabilityStatusNotReachable:                NSLog(@"沒有網絡");                break;            case AFNetworkReachabilityStatusReachableViaWWAN:                NSLog(@"3G");                break;            case AFNetworkReachabilityStatusReachableViaWiFi:                NSLog(@"無線");                break;                            default:                break;        }    }];    // 開啟    [manager startMonitoring];

6. AFN向HTTPS發送請求。

我們知道HTTPS在HTTP的基礎上加入了SSL協議,SSL依靠證書來驗證服務器的身份,并為瀏覽器和服務器之間的通信加密。 當使用NSURLSession來向HTTPS發送請求時,需要在NSURLSessionDataDelegate的代理方法didReceiveChallenge中,信任服務器并且創建證書返回服務器。 而AFN對此進行了很好的封裝,內部已經幫我們做好這些,因此向HTTPS發送請求方法與向HTTP發送請求是一樣的。 我們來看AFN內部封裝的方法

AFN內部封裝的方法

那么當我們用NSURLSession向HTTPS發送請求的時候,直接復制過來稍作修改就可以用啦

-(void)URLSession:(NSURLSession *)session didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition, NSURLCredential * _Nullable))completionHandler{    NSLog(@"--didReceiveChallenge--%@",challenge.protectionSpace);    /*     NSURLSessionAuthChallengeUseCredential = 0,      使用     NSURLSessionAuthChallengePerformDefaultHandling = 1,   忽略(默認)     NSURLSessionAuthChallengeCancelAuthenticationChallenge = 2,忽略(會取消請求)     NSURLSessionAuthChallengeRejectProtectionSpace = 3, 忽略(下次繼續詢問)     */    // NSURLAuthenticationMethodServerTrust 服務器信任    if ([challenge.protectionSpace.authenticationMethod isEqualToString:NSURLAuthenticationMethodServerTrust]) {        //創建證書        NSURLCredential *credentoal = [[NSURLCredential alloc]initWithTrust:challenge.protectionSpace.serverTrust];        completionHandler(NSURLSessionAuthChallengeUseCredential,credentoal);    }}