
用原生 API 下載檔案時,最容易被忽略但最關鍵的一件事是:先搞清楚伺服器上的檔案有多大。而要知道大小,不一定要真的下載。
- (void)viewDidLoad {
[super viewDidLoad];
[self download];
}
- (void)download {
NSURL *url = [NSURL URLWithString:@"https://local/~apple/itcase/download/iTunesConnect_DeveloperGuide_CN.zip"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
// HEAD 方法只取目標檔案的標頭資訊,不傳輸內容
[request setHTTPMethod:@"HEAD"];
NSURLResponse *response = nil;
NSData *data = [NSURLConnection sendSynchronousRequest:request
returningResponse:&response
error:nil];
// expectedContentLength 就是檔案的總長度
NSLog(@"%lld", [response expectedContentLength]);
}
HEAD 是 HTTP 的標準方法之一,語意就是「只要標頭」。在斷點續傳的情境裡,它是整個流程的第一步,因為不知道總長度就無從切分範圍。
[request setValue:@"bytes=0-499" forKeyPath:@"range"]; // 代表只讀取第 0 個位元組到第 499 個位元組
Range 是 HTTP 標頭中的範圍指定。伺服器若支援,會只回傳這一段內容,狀態碼為 206 Partial Content。把這個能力與 HEAD 結合,斷點續傳的骨架就成形了。
第一步,用 HEAD 取得目標檔案的總大小。
第二步,在磁碟上建立一個暫時的緩衝檔,大小與目標檔完全相同,內容預設填 0。這個「先挖好坑」的動作很重要,因為後續各段資料要寫入各自的位置,檔案必須先存在且大小正確。
第三步,開啟多執行緒,各自發出不同的 Range 請求,抓取不同的區塊。
第四步,每個區塊下載完成後,寫入對應的位移位置。
第五步,所有區塊都到齊後,把暫存檔改名為目標檔名,完成。
第一個難點是「先建同尺寸檔案」。這一步做不到,後面的隨機寫入就無從談起。
第二個是檔案讀寫的位置控制。Objective-C 中 NSData 的寫入預設是覆蓋或附加,若要指定位置,必須用 NSFileHandle 搭配 seekToFileOffset 移動檔案指標,再寫入。
NSFileHandle *handle = [NSFileHandle fileHandleForWritingAtPath:tempPath]; [handle seekToFileOffset:offset]; [handle writeData:chunkData];
第三個也是最麻煩的:多執行緒同時寫入同一個檔案時的鎖定問題。若不加以保護,兩段資料可能寫到同一個位置,或造成檔案結構錯亂。實務上有兩種常見策略,一是讓每個執行緒各自寫入獨立的分片檔案、最後再合併;二是對 fileHandle 的操作加上鎖。前者在並行度上更好,也更不容易出錯。
NSURLConnection 的同步方法在正式專案中並不建議使用,它會阻塞呼叫執行緒,且無法回報進度。真實場景請改用 NSURLSession 搭配 NSURLSessionDownloadTask,它天生支援暫存、續傳與進度回调,甚至能在 App 被背景化後由系統代為完成下載。上面這套 Range 拆分的邏輯仍值得理解,因為它是所有續傳機制的共同基礎。