行動端開發幾乎一定會碰到的五個網路環節:網路狀態檢測、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];
}
#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);
}];
}
#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);
}];
}
#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)。
#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];
}
cancel。AFHTTPRequestOperationManager 在 AFNetworking 3.0 中已被移除,全面改用 AFURLSessionManager。新專案請直接採用後者,或直接基於 URLSession 自行封裝。Documents 會被 iCloud/iTunes 備份,Library/Caches 不會。快取類檔案請放 Caches,避免佔用使用者備份空間。這五個環節——檢測、GET/POST、上傳、下載、續傳——涵蓋了絕大多數 App 的網路需求。理解背後的 HTTP 語意(方法、標頭、Range、multipart)比記住某個庫的 API 更重要,因為框架會換,協定不會。