JavaScript 最初是為瀏覽器而生,天生擅長處理 Unicode 字串,卻不擅長處理二進位資料。這對 Node.js 是個挑戰,因為 Node.js 主要用於在網路上傳輸常以二進位格式呈現的資料,例如:
為了解決這個問題,Buffer 模塊為 Node.js 帶來了儲存原始資料的能力,讓二進位資料得以在 JavaScript 的環境中被操作。每當需要處理 I/O 操作中移動的資料時,都很可能會用到 Buffer 模塊。
Buffer 類別是一個全域變數型別,用於直接處理二進位資料。原始資料儲存在 Buffer 類別的實例中,而一個 Buffer 實例的概念近似於一個整數陣列。它可以透過多種方式建立:
此外還有幾個常用的類別方法:
除了讀取檔案取得 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 事件時,資料就會被寫入可寫流中。
可讀流上幾個常用的方法:
Writable(可寫)流介面是對「資料寫入某個目標」這件事的抽象。
1. writable.write(chunk, [encoding], [callback])
該方法會向底層系統寫入資料,並在資料處理完畢後呼叫指定的回呼。
2. writable.cork():強制滯留所有寫入。被滯留的資料會在呼叫 .uncork() 或 .end() 時才寫入。
3. writable.end([chunk], [encoding], [callback])
呼叫 end() 後再呼叫 write() 會產生錯誤:
// 寫入 'hello, ' 然後以 'world!' 結束
http.createServer(function (req, res) {
res.write('hello, ');
res.end('world!');
// 現在不允許繼續寫入了
});
掌握 Buffer 與 Stream 這兩大模塊,是深入 Node.js I/O 程式設計的重要基礎。