DIV CSS 佈局教程網

Node.js 緩衝(Buffer)與流(Stream)模塊詳解
編輯:關於JavaScript     

緩衝(Buffer)模塊

JavaScript 最初是為瀏覽器而生,天生擅長處理 Unicode 字串,卻不擅長處理二進位資料。這對 Node.js 是個挑戰,因為 Node.js 主要用於在網路上傳輸常以二進位格式呈現的資料,例如:

  • 透過 TCP 連線收發資料;
  • 從圖片或壓縮檔讀取二進位資料;
  • 從檔案系統讀寫資料;
  • 處理來自網路的二進位資料流。

為了解決這個問題,Buffer 模塊為 Node.js 帶來了儲存原始資料的能力,讓二進位資料得以在 JavaScript 的環境中被操作。每當需要處理 I/O 操作中移動的資料時,都很可能會用到 Buffer 模塊。

類別:Buffer

Buffer 類別是一個全域變數型別,用於直接處理二進位資料。原始資料儲存在 Buffer 類別的實例中,而一個 Buffer 實例的概念近似於一個整數陣列。它可以透過多種方式建立:

  1. new Buffer(size):配置一個大小為 size 的 8 位元組緩衝區。
  2. new Buffer(array):以一個 8 位元組的 array 陣列配置新的緩衝區。
  3. new Buffer(str, [encoding]):以指定編碼方式將字串配置為緩衝區,encoding 為可選參數。

此外還有幾個常用的類別方法:

  • Buffer.isEncoding(encoding):若指定的編碼有效則回傳 true,否則回傳 false。
  • Buffer.isBuffer(obj):測試 obj 是否為 Buffer,回傳 Boolean。
  • Buffer.concat(list, [totalLength]):將 Buffer 陣列 list 中的所有內容合併,totalLength 為合併後的總大小。

除了讀取檔案取得 Buffer 實例外,也能直接建構,例如:

var bin = new Buffer([0x48, 0x65, 0x6c, 0x6c, 0x6c]);

Buffer 與字串類似,除了能用 .length 取得位元組長度,也能以 [index] 的方式讀取指定位置的位元組:

bin[0]; // => 0x48;

Buffer 與字串之間可以互相轉換,例如以指定編碼將二進位資料轉為字串:

var str = bin.toString('utf-8'); // => "hello"

值得注意的是,.slice 方法並不會回傳一個新的 Buffer,而更像是回傳一個指向原 Buffer 某個位置的指標:

[ 0x48, 0x65, 0x6c, 0x6c, 0x6c ]
    ^              ^
    |              |
  bin         bin.slice(2)

寫入緩衝區

var buffer = new Buffer(8); // 配置 8 個位元組的緩衝區
console.log(buffer.write('a', 'utf8')); // 輸出 1

這會將字元 "a" 寫入緩衝區,Node.js 回傳經編碼後實際寫入的位元組數量,而字母 a 的 utf-8 編碼佔用 1 個位元組。

複製緩衝區

Node.js 提供了將一個 Buffer 物件的內容整體複製到另一個 Buffer 的方法。由於只能在已存在的 Buffer 之間複製,因此必須先建立來源與目標 Buffer:

buffer.copy(bufferToCopyTo)

其中 bufferToCopyTo 是複製的目標 Buffer。範例如下:

var buffer1 = new Buffer(8);
buffer1.write('nice to meet u', 'utf8');
var buffer2 = new Buffer(8);
buffer1.copy(buffer2);
console.log(buffer2.toString()); // nice to meet u

流模塊

在 UNIX 類型的作業系統中,「流」是一個標準概念,主要包含三種:標準輸入、標準輸出與標準錯誤。

可讀流

如果說緩衝區是 Node.js 處理原始資料的方式,那麼流通常就是 Node.js 移動資料的方式。Node.js 中的流可分為可讀與可寫兩種,許多模塊(包括 HTTP 與檔案系統)都採用了流的概念。

假設我們建立一個 classmates.txt 檔,從中讀入姓名清單。由於資料是以流的形式呈現,代表在檔案完全讀取完成之前,就能從收到最初的幾個位元組開始處理資料,這是 Node.js 常見的模式:

var fs = require('fs');
var stream = fs.ReadStream('classmates.txt');
stream.setEncoding('utf8');
stream.on('data', function (chunk) {
    console.log('read some data');
});
stream.on('close', function () {
    console.log('all the data is read');
});

在上例中,每當收到新資料時便觸發 data 事件;當檔案讀取完成後則觸發 close 事件。

可寫流

同樣地,我們也能建立可寫流來寫入資料。這意味著只要一段簡單的腳本,就能用流讀入一個檔案並寫入另一個檔案:

var fs = require('fs');
var readableStream = fs.ReadStream('classmates.txt');
var writableStream = fs.WriteStream('names.txt');
readableStream.setEncoding('utf8');
readableStream.on('data', function (chunk) {
    writableStream.write(chunk);
});
readableStream.on('close', function () {
    writableStream.end();
});

現在,每當接收到 data 事件時,資料就會被寫入可寫流中。

可讀流上幾個常用的方法:

  • readable.setEncoding(encoding):設定編碼,回傳 this。
  • readable.resume():讓可讀流繼續觸發 data 事件。
  • readable.pause():讓處於流動模式的流停止觸發 data 事件,切換為非流動模式,並將後續可用資料留在內部緩衝區中。

類別:stream.Writable

Writable(可寫)流介面是對「資料寫入某個目標」這件事的抽象。

1. writable.write(chunk, [encoding], [callback])

  • chunk {String | Buffer}:要寫入的資料。
  • encoding {String}:當 chunk 為字串時的編碼。
  • callback {Function}:資料塊寫入後的回呼。
  • 回傳 {Boolean}:若資料已被全部處理則回傳 true。

該方法會向底層系統寫入資料,並在資料處理完畢後呼叫指定的回呼。

2. writable.cork():強制滯留所有寫入。被滯留的資料會在呼叫 .uncork() 或 .end() 時才寫入。

3. writable.end([chunk], [encoding], [callback])

  • chunk {String | Buffer}:可選,要寫入的資料。
  • encoding {String}:當 chunk 為字串時的編碼。
  • callback {Function}:可選,流結束後的回呼。

呼叫 end() 後再呼叫 write() 會產生錯誤:

// 寫入 'hello, ' 然後以 'world!' 結束
http.createServer(function (req, res) {
  res.write('hello, ');
  res.end('world!');
  // 現在不允許繼續寫入了
});

掌握 Buffer 與 Stream 這兩大模塊,是深入 Node.js I/O 程式設計的重要基礎。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved