在 iOS 與 macOS 開發中,NSStream 是一組處理資料串流的基礎類別。它允許開發者以串流方式讀取或寫入資料,而不必一次將全部內容載入記憶體。對於大型檔案、網路資料或需要持續傳輸的場景,串流處理是非常實用的工具。

Cocoa 中與串流相關的核心類別包括 NSStream、NSInputStream 與 NSOutputStream。NSStream 是抽象基礎類別,定義了串流物件的通用介面與屬性;NSInputStream 負責讀取資料,NSOutputStream 負責寫入資料。
你可以為記憶體中的資料、檔案或網路 socket 建立輸入串流,也可以為檔案、記憶體緩衝區或網路連線建立輸出串流。透過串流,資料可以分段處理,而不需要一次性佔用大量記憶體。
多數串流屬性與網路安全有關,例如 SSL 與 SOCKS 代理設定。此外,還有兩個常見屬性值得注意:一個是 NSStreamDataWrittenToMemoryStreamKey,可用來取得寫入記憶體串流的資料;另一個是 NSStreamFileCurrentOffsetKey,可用於調整檔案串流的讀寫位置。
使用 NSInputStream 時,一般流程如下:
從資料來源建立並初始化 NSInputStream 物件。
設定 delegate,並將串流加入 RunLoop。
呼叫 open 開始讀取。
在 delegate 方法中處理串流事件。
讀取完畢後,關閉串流並釋放資源。
資料來源可以是檔案、NSData 物件或網路 socket。建立串流後,必須設定 delegate,並透過 scheduleInRunLoop 將串流加入目前的 RunLoop,這樣系統才能在串流有資料可讀時通知 delegate。
在事件處理中,最常見的事件包括 NSStreamEventOpenCompleted、NSStreamEventHasBytesAvailable 與 NSStreamEventEndEncountered。當收到有資料可讀的事件時,可以呼叫 read maxLength 將資料讀入緩衝區。
- (void)stream:(NSStream *)stream handleEvent:(NSStreamEvent)eventCode
{
switch (eventCode) {
case NSStreamEventHasBytesAvailable:
break;
default:
break;
}
}每次讀取的大小通常會採用 512 bytes、1 KB 或 4 KB 等合理值。讀取到的資料可以附加到 NSMutableData 中,直到串流結束。
輸出串流的使用方式與輸入串流類似,差別在於它處理的是寫入事件。建立 NSOutputStream 後,同樣需要設定 delegate、加入 RunLoop,並呼叫 open。
常見事件包括 NSStreamEventOpenCompleted、NSStreamEventHasSpaceAvailable 與 NSStreamEventEndEncountered。當串流告訴你有空間可寫入時,就可以呼叫 write maxLength 將資料寫入。
若輸出目標是記憶體,可以在串流結束後透過 NSStreamDataWrittenToMemoryStreamKey 取得已寫入的資料。若輸出目標是檔案或網路,則資料會直接送往對應裝置或連線。
在實作時,通常會維護一個 byteIndex 或類似游標,用來記錄目前已寫入的位置。每次寫入成功後,再更新這個索引,直到所有資料都處理完成。
當串流抵達結尾,或不再需要繼續處理時,應該關閉串流、從 RunLoop 中移除,並釋放相關物件。這是避免資源洩漏與殘留事件的重要步驟。
整體而言,NSStream 提供了一個低層但通用的資料傳輸方式。若需求較簡單,且已有 NSURL、NSFileHandle 等高階 API 可用,通常可以優先使用高階方案;但若需要更細緻的控制,例如自訂緩衝、分段處理或特殊網路流程,NSStream 仍然是值得掌握的基礎工具。