萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js Stream 串流機制深度解析:從管道到背壓控制

什麼是 Stream?

Stream(串流)是 Node.js 處理資料流的核心抽象,源自 Unix 哲學:**「一切皆檔案,程式透過管道 `|` 串接」**。一個程式的標準輸出可直接作為下一個程式的標準輸入,實現記憶體高效的資料處理。

在 Node 中,Stream 代表**可被管道串接的資料流能力**,核心方法為 .pipe():

// 伪代碼
Readable.pipe(Writable); // 上游.pipe(下游)

Stream 四大類型

類型 繼承自 核心實作方法 典型例子
Readable (可讀)EventEmitter_read()fs.createReadStream, HTTP request, process.stdin
Writable (可寫)EventEmitter_write()fs.createWriteStream, HTTP response, process.stdout
Duplex (雙工)Readable + Writable兩者皆需實作net.Socket, zlib
Transform (轉換)Duplex_transform()zlib.createGzip, crypto.createCipher

核心事件與方法

Readable 端

  • 事件:readable、data、end、close、error
  • 方法:.read()、.pause()、.resume()、.pipe()、.unpipe()

Writable 端

  • 事件:drain、pipe、unpipe、error、finish
  • 方法:.write()、.end()、.cork()、.uncork()

Readable 兩種模式切換

初始為 **Paused Mode(暫停模式)**,需主動讀取;切換為 **Flowing Mode(流動模式)**:

觸發行為切換方向
監聽 data 事件Paused → Flowing
呼叫 .resume()Paused → Flowing
呼叫 .pipe(writable)Paused → Flowing
未 pipe 時呼叫 .pause()Flowing → Paused
已 pipe 時移除所有 data 監聽並 .unpipe()Flowing → Paused

實戰範例:處理 Shell 命令輸出

// parser.js
process.stdin.on('readable', function() {
  var buf = process.stdin.read();
  if (buf) {
    var data = buf.toString();
    // parsing data ...
    console.log('收到:', data.trim());
  }
});

// 使用:head -10 some.txt | node parser.js

經典 Socket 範例

req.on('connect', function(res, socket, head) {
  socket.on('data', function(chunk) {
    console.log(chunk.toString());
  });
  socket.on('end', function() {
    proxy.close();
  });
});

進階應用:跨請求串流轉發

// 用戶 A 上傳 → 暫存 req
router.post('/post', function(req, res) {
  var destination = req.headers['destination'];
  cache[destination] = req; // 不回應,保持連線
});

// 用戶 B 請求 → 串流轉發
router.get('/inbox', function(req, res) {
  var user = req.headers['user'];
  cache.find(user, function(err, previousReq) {
    var form = new multiparty.Form();
    form.parse(previousReq);
    form.on('part', function(part) {
      part.pipe(res); // 直接管道轉發,零記憶體複製
      part.on('error', function(err) { res.end(err); });
    });
  });
});

Stream 實作基礎:EventEmitter

var EE = require('events').EventEmitter;
var util = require('util');
util.inherits(Stream, EE);

function Stream() { EE.call(this); }

Stream 本質是 EventEmitter,擁有完整事件驅動能力,符合 Node.js 非同步非阻塞本質。

參考資源

掌握 Stream,即掌握 Node.js 高效 I/O 的靈魂。從簡單的檔案複製到複雜的即時轉碼、代理轉發,Stream 都是不可或缺的利器。

copyright © 萬盛學電腦網 all rights reserved