AFN的簡單使用

AFNetworking是一個令人愉快的iOS和Mac OS X的網絡庫。它建立在基礎URL加載系統之上,擴展了Cocoa中內置的強大的高級網絡抽象。它有一個模塊化架構,設計良好,功能豐富的API,使用起來很方便。

  • AFN的簡介
    • 簡介
    • 請求數據格式
    • 響應數據格式
    • 數據格式小結
  • AFN模擬登陸
    • 發送GET請求獲取普通的Json數據
    • AFN發送GET請求模擬登陸
    • AFN發送POST請求模擬登陸
  • AFN常見錯誤
  • AFN實現文件上傳和下載
    • 文件上傳
    • 文件下載
  • AFN常用功能
    • AFN之BaseURL
    • AFN之HTTPS
    • AFN之監測網絡環境
  • 封裝簡單的網絡請求工具類

AFN的簡介

簡介
  • 目前國內開發網絡應用使用最多的第三方框架
  • 是專為Mac OSiOS設計的一套網絡框架
  • NSURLConnectionNSURLSession做了封裝
  • 提供有豐富的API
  • 提供了完善的錯誤解決方案
  • 使用起來相對來說比較簡單
  • 官網地址:AFNetworking
請求數據格式
  • AFURLRequestSerialization

| 類型 | 說明 |
| --- | :---: | ---:|
| AFHTTPRequestSerializer | 二進制的,默認的 |
| AFJSONRequestSerializer | JSON(POST JSON) RESTful 設計風格需要 |
| AFPropertyListRequestSerializer | PList(POST Plist-開發中幾乎不用) |

響應數據格式
  • AFURLResponseSerialization

| 類型 | 說明 |
| --- | :---: | ---:|
| AFHTTPResponseSerializer | HTTP二進制的 |
| AFJSONResponseSerializer | JSON默認的 |
| AFXMLParserResponseSerializer | XML Parser解析器 SAX解析 |
| AFXMLDocumentResponseSerializer | (Mac OS X) XML DOM |
| AFPropertyListResponseSerializer | PList幾乎不用 |
| AFImageResponseSerializer | 圖像,不支持GIF |
| AFCompoundResponseSerializer | 組合的 |

數據格式小結
  • 大多數情況下,都是JSON格式,不需要指定
  • 如果是XML格式
    • 如果SAX解析,需要指定格式
      • manager.responseSerializer = [AFXMLParserResponseSerializer serializer];
    • 然后利用代理方法解析
    • 如果DOM解析,需要指定格式
      • manager.responseSerializer = [AFHTTPResponseSerializer serializer];
    • 然后利用第三方框架解析
  • 圖像
    • AFN支持圖像緩存
    • 但是不支持GIF
  • 提示
    • 使用AFN時,一定記住要輸出:error

AFN模擬登陸

導入頭文件:#import "AFNetworking.h

發送GET請求獲取普通的JSON數據
- (IBAction)demo:(id)sender
{
    // 1.網絡請求地址
    NSString *URLString = @"http://xxxx/demo.json";

    // 2.創建網絡請求管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 3.發送網絡請求
    [manager GET:URLString parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@ %@",[responseObject class],responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}

AFN發送GET請求模擬登陸
- (IBAction)GETLogin:(id)sender {

    // NSString *URLString = @"http://xxxx/php/login/login.php?username=zhangsan&password=zhang";

    // 登陸地址
    NSString *URLString = @"http://xxxx/php/login/login.php";

    // 網絡請求管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 請求參數
    NSMutableDictionary *parameters = [NSMutableDictionary dictionary];
    parameters[@"username"] = @"zhangsan";
    parameters[@"password"] = @"zhang";

    // 發送GET請求
    [manager GET:URLString parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@",responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}


AFN發送POST請求模擬登陸
- (IBAction)POSTLogin:(id)sender {

    // 登陸地址
    NSString *URLString = @"http://xxxx/php/login/login.php";

    // 網絡請求管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 請求參數
    NSMutableDictionary *parameters = [NSMutableDictionary dictionary];
    parameters[@"username"] = @"zhangsan";
    parameters[@"password"] = @"zhang";

    // 發送POST請求
    [manager POST:URLString parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@",responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}

AFN常見錯誤

AFN常見的序列化和反序列化的錯誤
 1.常見錯誤一 :
    AFN支持接收 @"application/json", @"text/json", @"text/javascript" 文本類型
    AFN不支持接收 text/html 文本類型

 2.常見錯誤二 :
    AFN默認的成功的回調 responseObject 是把服務器返回的數據當做JSON數據格式解析,返回字典或者數組.
    但是在加載網頁數據時,響應體是字符串.需要修改響應的序列化方式,讓AFN給我們返回原始的二進制數據即可.

 3.常見錯誤三 :
    AFN不支持接收 text/plian 文本類型

 4.常見錯誤四 :
    AFN默認只支持向服務器發送普通的二進制數據.比如普通的GET和POST請求數據.默認不支持發送JSON數據到服務器
    如果要向服務器發送JSON格式的二進制數據,就需要特殊的處理請求的方式.使AFN支持向服務器發送JSON形式的二進制數據

其他常見錯誤
  • 加載網頁數據時
- (void)loadData
{
    // 網絡請求manager
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 常見錯誤一 : 修改AFN支持接收的文本類型 : text/html
    manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/html", nil];

    // 常見錯誤二 : 修改AFN默認的返回的數據類型,設置默認為只返回原始的二進制數據,程序猿自己解析
    manager.responseSerializer = [AFHTTPResponseSerializer serializer];

    // 網絡請求地址
    NSString *URLStr = @"http://www.baidu.com";

    // 發送網絡請求
    [manager GET:URLStr parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

//        NSLog(@"%@ %@",[responseObject class],responseObject);

        NSString *html = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
        NSLog(@"%@",html);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"出錯 %@",error);
    }];
}

  • 向服務器發送JSON數據時
- (void)postJSON
{
    // 網絡請求manager
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 常見錯誤三 : 修改AFN支持接收的文本類型 : text/plian
    manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/html", @"text/plain", nil];

    // 常見錯誤二 : 修改AFN默認的返回的數據類型,設置默認為只返回原始的二進制數據,程序猿自己解析
    manager.responseSerializer = [AFHTTPResponseSerializer serializer];

    // 常見錯誤四 : 修改AFN支持向服務器發送JSON形式的二進制數據
    manager.requestSerializer = [AFJSONRequestSerializer serializer];

    // 網絡請求地址
    NSString *URLStr = @"http://localhost/php/upload/postjson.php";

    // 請求參數
    NSDictionary *parameters = @{
                                    @"name":@"zhangsan"
                                };

    // 發送網絡請求
    [manager POST:URLStr parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

//        NSLog(@"%@ %@",[responseObject class],responseObject);

        NSString *html = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
        NSLog(@"%@",html);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"出錯 %@",error);
    }];
}

AFN實現文件上傳和下載

文件上傳
  • 文件數據拼接的方法

    • [formData appendPartWithFileData:data name:@"" fileName:@"" mimeType:@""];
  • 文件數據拼接的四個參數

    • 參數1:上傳文件的二進制信息
    • 參數2:服務器接收二進制數據的字段名(跟服務器要)
    • 參數3:文件保存到服務器的名字
    • 參數4:上傳的文件的類型
  • 文件上傳的主方法

- (void)uploadFile
{
    // 網絡請求地址
    NSString *URLStr = @"http://xxxx/php/upload/upload-m.php";

    // 文件上傳的附帶信息
    NSDictionary *textDict = @{
                                @"status":@"zhangsan"
                               };

    // 網絡請求manager
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    // 發送POST請求
    [manager POST:URLStr parameters:textDict constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {

        // 獲取文件路徑1
        NSString *filePath1 = [[NSBundle mainBundle] pathForResource:@"mm01.jpg" ofType:nil];
        NSData *fileData1 = [NSData dataWithContentsOfFile:filePath1];
        // 拼接數據1
        [formData appendPartWithFileData:fileData1 name:@"userfile[]" fileName:[filePath1 lastPathComponent] mimeType:@"image/jpg"];

        // 獲取文件路徑2
        NSString *filePath2 = [[NSBundle mainBundle] pathForResource:@"mm02.jpg" ofType:nil];
        NSData *fileData2 = [NSData dataWithContentsOfFile:filePath2];
        // 拼接數據2
        [formData appendPartWithFileData:fileData2 name:@"userfile[]" fileName:[filePath2 lastPathComponent] mimeType:@"image/jpg"];

    } progress:^(NSProgress * _Nonnull uploadProgress) {

        NSLog(@"進度 %f",uploadProgress.fractionCompleted);

    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@ %@",[responseObject class],responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"出錯 %@",error);
    }];
}

文件下載
- (void)downloadFile
{
    // 下載地址
    NSString *URLString = @"http://xxxx/xcode.zip";
    // 請求
    NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:URLString]];
    // 管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    // 發起下載任務
    NSURLSessionDownloadTask *downloadTask = [manager downloadTaskWithRequest:request progress:^(NSProgress * _Nonnull downloadProgress) {

        NSLog(@"進度 %f",downloadProgress.fractionCompleted);

    } destination:^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response) {

        // AFN提供的文件保存路徑,在tmp文件中,下載完成之后就會被刪除
        NSLog(@"%@",targetPath);

        // 自己獲取文件保存的路徑
        NSString *filePath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:response.suggestedFilename];

        // 帶file:// 協議頭
        NSURL *locationURL = [NSURL fileURLWithPath:filePath];

        // 把文件緩存路徑剪切出去
        return locationURL;

    } completionHandler:^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error) {
        // 文件最終保存的路徑 : 從上面自動剪切過來的
        NSLog(@"%@",filePath.path);
    }];
    // 開啟下載任務
    [downloadTask resume];
}

AFN其他常用功能

AFN之BaseURL
  • 使用場景:設計網絡請求工具類時使用
- (IBAction)baseURL:(id)sender
{
    AFHTTPSessionManager *manager = [[AFHTTPSessionManager alloc] initWithBaseURL:[NSURL URLWithString:@"http://localhost/"]];

    [manager GET:@"demo.json" parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@",responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}

AFN之HTTPS

// 允許無效的證書 : 2.5.4 版本之前使用
manager.securityPolicy.allowInvalidCertificates = YES;
// 不驗證域名 : 2.6.0 版本之后使用
manager.securityPolicy.validatesDomainName = NO;

- (IBAction)HTTPS:(id)sender
{
    // 創建網絡請求mansger
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 允許無效的證書
    // manager.securityPolicy.allowInvalidCertificates = YES;
    // 不驗證域名
    manager.securityPolicy.validatesDomainName = NO;

    // 修改AFN默認支持接收的文本類型
    manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/html" ,nil];

    // 修改AFN默認處理數據的方式 : 設置成只返回原始的二進制數據,程序猿自己反序列化
    manager.responseSerializer = [AFHTTPResponseSerializer serializer];

    // 網絡請求地址
    NSString *URLStr = @"https://www.baidu.com";

    [manager GET:URLStr parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        // NSLog(@"%@ %@",[responseObject class],responseObject);

        // 反序列化
        NSString *html = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
        NSLog(@"%@",html);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"出錯 %@",error);
    }];
}

AFN之監測網絡環境

  • 程序一啟動就開始監測網絡環境
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.

    // 監測網絡環境
    AFNetworkReachabilityManager *manager = [AFNetworkReachabilityManager sharedManager];

    /*
     status
     AFNetworkReachabilityStatusUnknown          = -1, 不知道監測的是什么
     AFNetworkReachabilityStatusNotReachable     = 0,  沒有檢測到網絡
     AFNetworkReachabilityStatusReachableViaWWAN = 1,  蜂窩網
     AFNetworkReachabilityStatusReachableViaWiFi = 2,  WIFI
     */
    [manager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
        NSLog(@"%zd",status);
    }];

    [manager startMonitoring];

    return YES;
}

封裝簡單的網絡請求工具類

新建類 NetworkTool
  • NetworkTool.h
// 第一步 : 繼承自 AFHTTPSessionManager
@interface NetworkTool : AFHTTPSessionManager

/**
 *  網絡請求工具類全局訪問點
 *
 *  @return AFHTTPSessionManager的實例
 */
+ (instancetype)sharedNetworkTool;

/**
 *  網絡請求工具類GET請求的主方法
 *
 *  @param URLString 請求地址
 *  @param success   成功的回調
 *  @param faile     失敗的回調
 */
- (void)GETWithURLString:(NSString *)URLString success:(void(^)(id responseObject))success faile:(void(^)(NSError *error))faile;

  • NetworkTool.m
+ (instancetype)sharedNetworkTool
{
    static NetworkTool *instance;
    
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        
        // 設置相對路徑
        NSURL *BaseURL = [NSURL URLWithString:@"http://c.m.163.com/nc/"];
        // 實例化Manager
        instance = [[self alloc] initWithBaseURL:BaseURL];
        
        // 增加AFN支持的文件類型
        instance.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/html", @"text/plain", nil];
    });
    
    return instance;
}

// 網絡工具類實現GET請求的主方法
- (void)GETWithURLString:(NSString *)URLString success:(void (^)(id))success faile:(void (^)(NSError *))faile
{
    [self GET:URLString parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
        
        if (success) {
            success(responseObject);
        }
        
    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        if (faile) {
            faile(error);
        }
    }];
}

感謝讀到最后的朋友,最后祝大家工作順利,請點贊支持一下,謝謝!

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,606評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,582評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,540評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,028評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,801評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,223評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,294評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,442評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,976評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,800評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,996評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,543評論 5 360
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,233評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,662評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,926評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,702評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,991評論 2 374

推薦閱讀更多精彩內容

  • Spring Cloud為開發人員提供了快速構建分布式系統中一些常見模式的工具(例如配置管理,服務發現,斷路器,智...
    卡卡羅2017閱讀 134,785評論 18 139
  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,662評論 25 708
  • 發現 關注 消息 iOS 第三方庫、插件、知名博客總結 作者大灰狼的小綿羊哥哥關注 2017.06.26 09:4...
    肇東周閱讀 12,153評論 4 61
  • 1、StringBuffer對象的初始化 1.StringBuffer 用在對多種數據類型的拼接,和若干次拼接,效...
    熊安安閱讀 529評論 0 1
  • 年歲漸長,常愛做夢,一個有著明亮笑容的少年會剝開夢的迷霧,坐在寬敞無人的教室里做作業,而我亦回到當初18歲的模樣,...
    小富閑人閱讀 998評論 6 4