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

iOS 開發:把 POST 異步請求封裝成一個通用工具類

編輯:iOS 開發綜合

每個專案都要發網絡請求,如果每頁都自己拼 NSURLRequest、自己處理回呼,程式碼很快就亂了。把「檢查網絡」與「POST 送出」抽成一個 HttpHelper 類別,之後呼叫端只要一行就能完成請求。

宣告介面

#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
#import "Reachability.h"

@interface HttpHelper : NSObject

// 檢查網絡是否可用
+ (BOOL)NetWorkIsOK;

// POST 請求封裝
+ (void)post:(NSString *)Url
     RequestParams:(NSDictionary *)params
      FinishBlock:(void (^)(NSURLResponse *response, NSData *data, NSError *connectionError))block;

@end

實作

// HttpHelper.m
#import "HttpHelper.h"

@implementation HttpHelper

#pragma mark - 網絡狀態檢查

// WiFi 或蜂窩數據任一可用即回傳 YES
+ (BOOL)NetWorkIsOK {
    if (([[Reachability reachabilityForInternetConnection] currentReachabilityStatus] != NotReachable) &&
        ([[Reachability reachabilityForLocalWiFi] currentReachabilityStatus] != NotReachable)) {
        return YES;
    }
    return NO;
}

#pragma mark - POST 異步請求

+ (void)post:(NSString *)URL RequestParams:(NSDictionary *)params FinishBlock:(void (^)(NSURLResponse *response, NSData *data, NSError *connectionError))block {
    // 字串轉 URL
    NSURL *url = [NSURL URLWithString:URL];

    // 初始化請求,可在此調整快取策略與逾時秒數
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url
                                                          cachePolicy:NSURLRequestReloadIgnoringCacheData
                                                      timeoutInterval:20];

    // 把 NSDictionary 解析成 a=1&b=2 這種 POST 字串
    NSString *parseParamsResult = [self parseParams:params];
    NSData *postData = [parseParamsResult dataUsingEncoding:NSUTF8StringEncoding];

    [request setHTTPMethod:@"POST"];
    [request setHTTPBody:postData];

    // 另開一條佇列(等於開新執行緒),避免阻塞主執行緒
    NSOperationQueue *queue = [NSOperationQueue new];

    // 送出異步請求,完成後透過 completionHandler 回呼
    [NSURLConnection sendAsynchronousRequest:request queue:queue completionHandler:block];
}

#pragma mark - 參數序列化

+ (NSString *)parseParams:(NSDictionary *)params {
    NSMutableString *result = [NSMutableString new];
    NSEnumerator *keyEnum = [params keyEnumerator];
    id key;
    while (key = [keyEnum nextObject]) {
        NSString *keyValueFormat = [NSString stringWithFormat:@"%@=%@&", key, [params valueForKey:key]];
        [result appendString:keyValueFormat];
    }
    NSLog(@"post() 方法參數解析結果:%@", result);
    return result;
}

@end

使用範例:登入

- (void)login {
    NSString *url = @"https://127.0.0.1/login.php";
    NSString *userName = @"admin";
    NSString *password = @"root";

    NSMutableDictionary *params = [NSMutableDictionary new];
    [params setValue:userName forKey:@"phone"];
    [params setValue:password forKey:@"password"];

    // 有網絡才發請求
    if ([HttpHelper NetWorkIsOK]) {
        [HttpHelper post:url RequestParams:params FinishBlock:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
            if (data) {
                // 回呼在子執行緒,更新 UI 前必須切回主執行緒
                [self performSelectorOnMainThread:@selector(login_callBack:) withObject:data waitUntilDone:YES];
            } else {
                NSLog(@"無效的數據");
            }
        }];
    }
}

// 登入回呼:判斷是否能登入,再決定提示或跳頁
- (void)login_callBack:(id)value {
    NSLog(@"登錄成功");
}

這份封裝可以再更好的地方

這個版本勝在簡單明瞭,很適合當作入門範例,但正式專案還建議補上幾件事:

  • 改用 NSURLSession:NSURLConnection 已被蘋果標記為 deprecated,NSURLSession 在連線管理、背景執行與取消請求上都更完善。
  • 參數編碼要處理:中文、空格與特殊字元必須做百分號編碼(stringByAddingPercentEncodingWithAllowedCharacters:),否則會送出錯誤的 body。另外字串拼接完記得去掉多餘的 &。
  • 回呼別忘了錯誤分支:目前只處理了 data 是否為空,實際上 connectionError 與 HTTP 狀態碼都該納入判斷。
  • 回呼執行緒要明確:在 completion 區塊中直接假設自己在主執行緒是危險的,建議統一用 dispatch_async(dispatch_get_main_queue(), ...) 或 NSURLSession 的 completionQueue 指定。
  • 避免循環引用:若在 block 中強引用 self,記得使用 weak 化身。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved