您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

AFNetworking 實戰筆記:request 與 response 序列化錯誤怎麼解

編輯:iOS 開發綜合

關於 AFNetworking

iOS 網路請求裡最常被使用的框架大概就是 AFNetworking。它是一個輕量級的網路通訊庫,架構在 NSURLConnection 以及 iOS 7.0 之後推出的 NSURLSession 之上,把許多網路通訊功能包得很乾淨。它支援 HTTP 請求與 REST 風格的網路服務(GET、POST、PUT 等),並且支援 ARC。

使用 AFN 時最常遇到的錯誤,幾乎都出在預設的資料解析格式與伺服器實際回傳格式不一致。AFN 預設幫你把回應序列化成 JSON、把參數序列化成 NSData;只要對不上,就會拋出解析錯誤,導致請求或回應失敗。下面分別說明兩個方向的解法。

一、response 回應:不要用預設的 JSON 序列化

response 預設會把資料轉成 JSON。如果伺服器回的就是 JSON,那沒問題;但若回的是 HTML、純字串或其他格式,就必须改掉預設行為——讓它原封不動地把資料交回來。不過原始資料是二進位,人看不懂,需要自己轉成字串(alloc + initWithData)。

解法重點:把 responseSerializer 換成 AFHTTPResponseSerializer,並在 acceptableContentTypes 中補上 text/html、text/plain 等實際會遇到的型別。

範例:請求百度並取得 HTML

// 請求百度,這是最常見的錯誤情境
- (void)demo {
    // 使用自訂的、繼承自 AFHTTPSessionManager 的管理者
    NetWorkTools *netWorkTool = [NetWorkTools sharedNetWorkTools];

    /**
     * 回應回來時,預設的序列化方法是 JSON
     * 這裡改用普通序列化方式,原樣取回二進位 HTML
     */
    netWorkTool.responseSerializer = [AFHTTPResponseSerializer serializer];

    [netWorkTool GET:@"https://www.baidu.com" parameters:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nonnull responseObject) {
        NSLog(@"%@--%@", responseObject, [responseObject class]);

        // 把二進位資料轉成 HTML 字串
        NSString *html = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
        NSLog(@"html = %@", html);
    } failure:^(NSURLSessionDataTask * _Nonnull task, NSError * _Nonnull error) {
        NSLog(@"%@", error.localizedDescription);
    }];
}

封裝一個全域可用的網路工具

// NetWorkTools.m
#import "NetWorkTools.h"

static NSString * const BASEURL = @"";

@implementation NetWorkTools

static NetWorkTools *_netWorkTools;

+ (instancetype)sharedNetWorkTools {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        _netWorkTools = [[self alloc] initWithBaseURL:[NSURL URLWithString:BASEURL]];

        // 補上伺服器實際會回傳的 content type
        _netWorkTools.responseSerializer.acceptableContentTypes =
            [NSSet setWithObjects:@"application/json", @"text/json",
             @"text/javascript", @"text/html", @"text/plain", nil];
    });
    return _netWorkTools;
}

@end

二、request 請求:把參數轉成伺服器吃得懂的 JSON

反方向的問題也一樣惱人。request 預設會把參數編成 NSData,但如果後端是 PHP 且只接受 JSON 格式,就必須改用 AFJSONRequestSerializer,否則伺服器無法反序列化。

補充一點常被忽略的知識:並不是所有資料都能轉成 JSON。可轉的情況包括:

  • 最外層是字典或陣列
  • 普通的字串
  • 自訂類別的物件——需先透過模型轉字典(例如用 KVC)處理,才能序列化

範例:以 JSON 格式 POST 資料

- (void)demo1 {
    // POST 請求:攜帶使用者資訊的參數建議用 POST,
    // 因為不會被快取、沒有長度限制,也不會暴露在 URL 後方,相對安全
    NSDictionary *params = @{
        @"username": @"abc",
        @"password": @"123"
    };

    NetWorkTools *netWorkTool = [NetWorkTools sharedNetWorkTools];

    // 後端是 PHP,只接受 JSON,因此請求序列化器要換掉
    netWorkTool.requestSerializer = [AFJSONRequestSerializer serializer];

    // 回應仍是原始二進位
    netWorkTool.responseSerializer = [AFHTTPResponseSerializer serializer];

    [netWorkTool POST:@"https://localhost/post/postjson.php"
           parameters:params
              success:^(NSURLSessionDataTask * _Nonnull task, id _Nonnull responseObject) {
        NSLog(@"%@--%@", responseObject, [responseObject class]);

        // 把二進位轉成 text/plain
        NSString *result = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
        NSLog(@"result = %@", result);
    } failure:^(NSURLSessionDataTask * _Nonnull task, NSError * _Nonnull error) {
        NSLog(@"%@", error.localizedDescription);
    }];
}

一句話總結

AFN 出錯九成不是網路問題,而是序列化器選錯了。記住這兩條對照關係就好:伺服器回什麼格式,responseSerializer 就要能對應(非 JSON 用 AFHTTPResponseSerializer 自己轉字串);伺服器要什麼格式,requestSerializer 就要產生什麼(PHP 吃 JSON 就用 AFJSONRequestSerializer)。把可接受型別補齊,錯誤自然消失。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved