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

iOS 網路請求:封裝一個通用的 NSURLConnection 類方法

編輯:iOS 開發綜合

使用 NSURLConnection 時,比較好的做法是把請求邏輯抽成一個類方法,讓任何地方都能直接呼叫並透過 block 取得結果。以下是一個可直接複用的範例。

// 建立類方法 —— 發送網路請求
+ (void)requestData:(NSString *)urlStr
         httpMethod:(NSString *)method
             params:(NSMutableDictionary *)params
   comletionHandle:(void (^)(id result))block {

    // 1. 組出完整 URL
    urlStr = [BASE_URL stringByAppendingString:urlStr];
    NSURL *url = [NSURL URLWithString:urlStr];

    // 2. 建立 request
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    request.timeoutInterval = 60;
    request.HTTPMethod = method;

    if ([method isEqualToString:@"GET"]) {
        // GET:把參數拼在網址後面
        NSMutableString *paramsStr = [[NSMutableString alloc] initWithString:@"?"];
        // 最終樣式類似:
        // https://api.example.com/2/statuses/home_timeline.json?access_token=xxx&username=aaa&pass=bbb
        for (int i = 0; i < params.count; i++) {
            NSString *key = params.allKeys[i];
            NSString *value = params[key];
            [paramsStr appendFormat:@"%@=%@", key, value];
            if (i < params.count - 1) {
                [paramsStr appendFormat:@"&"];
            }
        }
        request.URL = [NSURL URLWithString:[urlStr stringByAppendingString:paramsStr]];

    } else if ([method isEqualToString:@"POST"]) {
        // POST:把參數放進請求體
        NSMutableString *paramsStr = [[NSMutableString alloc] initWithString:@""];
        for (int i = 0; i < params.count; i++) {
            NSString *key = params.allKeys[i];
            NSString *value = params[key];
            [paramsStr appendFormat:@"%@=%@", key, value];
            if (i < params.count - 1) {
                [paramsStr appendFormat:@"&"];
            }
        }
        NSData *data = [paramsStr dataUsingEncoding:NSUTF8StringEncoding];
        request.HTTPBody = data;
    }

    // 3. 送出非同步請求
    NSOperationQueue *queue = [[NSOperationQueue alloc] init];
    [NSURLConnection sendAsynchronousRequest:request
                                       queue:queue
                           completionHandler:^(NSURLResponse *response,
                                               NSData *data,
                                               NSError *connectionError) {
        if (connectionError) {
            NSLog(@"error----%@", connectionError);
            return;
        }
        // 解析 JSON
        id result = [NSJSONSerialization JSONObjectWithData:data
                                                   options:NSJSONReadingMutableContainers
                                                     error:nil];
        // 回主線程回傳,方便直接更新 UI
        dispatch_async(dispatch_get_main_queue(), ^{
            block(result);
        });
    }];
}

幾個必須知道的實務細節

1. 中文必須編碼。 這個範例沒有處理編碼問題,但實際上 URL 中若含中文或空白,URLWithString: 會回傳 nil。使用前請先 stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding,iOS 9 之後則改用 NSURLComponents 並設定 queryItems,讓系統負責編碼。

2. 用 allKeys 的順序是字典型表的任意順序。 這段程式碼用 params.allKeys[i] 遍歷,每次執行參數順序可能不同。多數 API 不在意順序,但若你的後端要求簽章驗證,順序不一致會直接導致驗簽失敗,這時必須先排序或用陣列固定順序。

3. NSURLConnection 已被標記為廢棄。 自 iOS 9 起,Apple 建議改用 NSURLSession。若 APp 使用 ATS(App Transport Security),也必須確保目標伺服器支援 HTTPS 與 TLS 1.2,否則請求會被系統攔下。

4. 別忘了錯誤與非 2xx 狀態碼。 範例中只判斷了 connectionError,但伺服器回傳 401、500 時 data 仍會有值,解析後可能得到錯誤結構。正式環境建議一併檢查 NSHTTPURLResponse.statusCode。

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