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

iOS 網路開發實務:以 AFNetworking 實作檢測、GET/POST、上傳、下載與續傳

編輯:iOS 開發綜合

行動端開發幾乎一定會碰到的五個網路環節:網路狀態檢測、GET/POST 請求、檔案上傳、檔案下載、斷點續傳。本文以 AFNetworking 為例逐一實作。

一、網路狀態監聽

#pragma mark - Reachability Management

// 網路監聽(用於檢測網路是否可連線)
// 建議放在 AppDelegate,讓 App 一啟動就開始檢測
- (void)reachabilityManager
{
    // 開始監聽
    [manager.reachabilityManager startMonitoring];

    // 監聽網路變化
    [manager.reachabilityManager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
        switch (status) {

            // 網路不可用(無網路或請求逾時)
            case AFNetworkReachabilityStatusNotReachable:
                break;

            // Wi-Fi 或行動數據皆可正常使用
            case AFNetworkReachabilityStatusReachableViaWiFi:
            case AFNetworkReachabilityStatusReachableViaWWAN:
                break;

            default:
                break;
        }
    }];

    // 停止監聽(若需持續檢測則不停止)
    [manager.reachabilityManager stopMonitoring];
}

二、GET 請求

#pragma mark - GET Request

- (void)methodGet
{
    if (manager) manager = nil;

    manager = [AFHTTPRequestOperationManager manager];

    // 預設解析器為 AFJSONResponseSerializer(解析 JSON)
    // 若要直接拿原始 NSData,改用:
    // manager.responseSerializer = [AFHTTPResponseSerializer serializer];

    [manager GET:@"接口地址" parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {

        // 解析器為 AFJSONResponseSerializer 時,直接就是物件
        NSLog(@"Success: %@", responseObject);

        // 解析器為 AFHTTPResponseSerializer 時,需自行轉字串
        // NSString *JSONString = [[NSString alloc] initWithData:responseObject
        //                                               encoding:NSUTF8StringEncoding];
        // NSLog(@"success:%@", JSONString);

    } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
        NSLog(@"Error: %@", error);
    }];
}

三、POST 請求

#pragma mark - POST Request

- (void)methodPost
{
    if (manager) manager = nil;

    // 參數
    NSDictionary *parameters = @{ @"key1" : @"value1",
                                  @"key2" : @"value2" };

    manager = [AFHTTPRequestOperationManager manager];
    // manager.responseSerializer = [AFHTTPResponseSerializer serializer];

    [manager POST:@"接口地址" parameters:parameters success:^(AFHTTPRequestOperation *operation, id responseObject) {
        NSLog(@"Success: %@", responseObject);
    } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
        NSLog(@"Error: %@", error);
    }];
}

四、檔案上傳(multipart/form-data)

#pragma mark - Upload Request

- (void)methodUpload
{
    if (manager) manager = nil;

    NSDictionary *parameters = @{ @"key1" : @"value1" };

    manager = [AFHTTPRequestOperationManager manager];
    // manager.responseSerializer = [AFHTTPResponseSerializer serializer];

    [manager POST:@"接口地址"
       parameters:parameters
constructingBodyWithBlock:^(id formData) {

        // 讀取圖片並壓縮
        // 壓縮品質 0.0 為最大壓縮,1.0 為最小壓縮
        NSData *imageData = UIImageJPEGRepresentation([UIImage imageNamed:@"圖片名字"], 1.0);

        // 加入要上傳的檔案
        // name: 伺服器端接收的欄位名稱
        // fileName: 檔案名稱
        // mimeType: 檔案類型,圖片如 image/jpeg
        [formData appendPartWithFileData:imageData
                                    name:@"伺服器圖片欄位名"
                                fileName:@"圖片名字"
                                mimeType:@"image/jpeg"];

    } success:^(AFHTTPRequestOperation *operation, id responseObject) {
        NSLog(@"Success: %@", responseObject);
    } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
        NSLog(@"Error: %@", error);
    }];
}

若要上傳多張圖片,在同一個 constructingBodyWithBlock 中重複呼叫 appendPartWithFileData: 即可,每一筆的 name 可相同也可不同,端看後端 API 的設計。

五、檔案下載(含進度條)

#pragma mark - Download Request

- (void)methodDownload
{
    // 進度條
    UIProgressView *downProgressView =
        [[UIProgressView alloc] initWithProgressViewStyle:UIProgressViewStyleDefault];
    downProgressView.center = CGPointMake(self.view.center.x, 220);
    downProgressView.progress = 0;
    downProgressView.progressTintColor = [UIColor blueColor];
    downProgressView.trackTintColor    = [UIColor grayColor];
    [self.view addSubview:downProgressView];

    // 存到 Documents 目錄
    // 方法一:用 API 取得路徑
    // NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    // NSString *dir = [paths objectAtIndex:0];
    // NSString *filePath = [dir stringByAppendingPathComponent:@"文件名"];

    // 方法二:直接用 NSHomeDirectory 組字串
    NSString *filePath = [NSString stringWithFormat:@"%@/Documents/文件名",
                          NSHomeDirectory()];
    NSLog(@"%@", filePath);

    // 建立請求操作
    operation = [[AFHTTPRequestOperation alloc]
                 initWithRequest:[NSURLRequest requestWithURL:
                                  [NSURL URLWithString:@"下載地址"]]];

    // 把伺服器回應串流直接寫入檔案,避免整檔進記憶體
    operation.outputStream = [NSOutputStream outputStreamToFileAtPath:filePath append:NO];

    // 進度回呼
    [operation setDownloadProgressBlock:^(NSUInteger bytesRead,
                                          long long totalBytesRead,
                                          long long totalBytesExpectedToRead) {
        CGFloat progress = ((float)totalBytesRead) / totalBytesExpectedToRead;
        [downProgressView setProgress:progress animated:YES];
    }];

    // 完成回呼
    [operation setCompletionBlockWithSuccess:^(AFHTTPRequestOperation *operation, id responseObject) {
        NSLog(@"Finish and Download to: %@", filePath);
    } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
        NSLog(@"Error: %@", error);
    }];
}

關鍵在 outputStream——設定它之後,AFNetworking 會把資料串流寫檔,不必等整檔下載完再配置記憶體。下載大檔時這是必備設定。

六、斷點續傳

#pragma mark - Download Management

// 開始下載
- (void)downloadStart
{
    [self methodDownload];
    [operation start];
}

// 暫停(此 operation 會記住已下載的位置)
- (void)downloadPause
{
    [operation pause];
}

// 續傳
- (void)downloadResume
{
    [operation resume];
}

AFHTTPRequestOperation 的 pause/resume 之所以能續傳,是因為暫停時它會把已接收的資料寫入暫存檔並記錄位元組偏移,恢復時自動帶上 Range 請求標頭,向伺服器索取剩餘部分。前提是伺服器必須支援 HTTP Range 請求(回應標頭含 Accept-Ranges: bytes)。

七、iOS 7 以後的 NSURLSession 寫法

#pragma mark - Upload (iOS 7+)

- (void)methodUploadFor7
{
    if (sessionManager) sessionManager = nil;

    sessionManager =
        [[AFURLSessionManager alloc] initWithSessionConfiguration:
         [NSURLSessionConfiguration defaultSessionConfiguration]];

    NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"上傳地址"]];
    NSURL *filePath = [NSURL fileURLWithPath:@"本地文件地址"];

    NSURLSessionUploadTask *uploadTask =
        [sessionManager uploadTaskWithRequest:request
                                     fromFile:filePath
                                     progress:nil
                            completionHandler:^(NSURLResponse *response,
                                                id responseObject,
                                                NSError *error) {
        if (error) {
            NSLog(@"Error: %@", error);
        } else {
            NSLog(@"Success: %@ %@", response, responseObject);
        }
    }];

    [uploadTask resume];
}


#pragma mark - Download (iOS 7+)

- (void)methodDownloadFor7
{
    if (sessionManager) sessionManager = nil;

    sessionManager =
        [[AFURLSessionManager alloc] initWithSessionConfiguration:
         [NSURLSessionConfiguration defaultSessionConfiguration]];

    NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"下載地址"]];

    NSURLSessionDownloadTask *downloadTask =
        [sessionManager downloadTaskWithRequest:request
                                       progress:nil
                                    destination:^NSURL *(NSURL *targetPath, NSURLResponse *response) {
        // 決定檔案要存去哪裡
        NSURL *dir = [NSURL fileURLWithPath:
                      [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
                                                           NSUserDomainMask, YES) firstObject]];
        return [dir URLByAppendingPathComponent:[response suggestedFilename]];

    } completionHandler:^(NSURLResponse *response, NSURL *filePath, NSError *error) {
        NSLog(@"Finish and Download to: %@", filePath);
    }];

    [downloadTask resume];
}

幾個重要的實務提醒

  • HTTPS 是基本要求:iOS 9 起 App Transport Security(ATS)預設禁止明文 HTTP。除非有特殊需求,請不要為了方便而關閉 ATS——那會讓使用者資料暴露在風險中。
  • 錯誤處理要完整:範例只印 log,正式專案必須區分「無網路」、「逾時」、「伺服器 4xx/5xx」、「回應格式錯誤」並給出對應的 UI 提示與重試機制。
  • 請求要能取消:使用者離開頁面時應取消未完成的請求,避免洩漏與資源浪費。保留 operation/task 的參照即可呼叫 cancel。
  • API 世代差異:AFHTTPRequestOperationManager 在 AFNetworking 3.0 中已被移除,全面改用 AFURLSessionManager。新專案請直接採用後者,或直接基於 URLSession 自行封裝。
  • Token 與簽章:不要把 API Key 或密鑰硬編碼在用戶端。敏感操作應由後端簽章,或用短期 token 機制。
  • 檔案下載路徑:Documents 會被 iCloud/iTunes 備份,Library/Caches 不會。快取類檔案請放 Caches,避免佔用使用者備份空間。

這五個環節——檢測、GET/POST、上傳、下載、續傳——涵蓋了絕大多數 App 的網路需求。理解背後的 HTTP 語意(方法、標頭、Range、multipart)比記住某個庫的 API 更重要,因為框架會換,協定不會。

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