DIV CSS 佈局教程網

Node.js Buffer 詳解:二進位資料的建立、讀寫與編解碼
編輯:關於JavaScript     

JavaScript 天生擅長字串,卻天生不擅長二進位。原因不難理解:它最初是為了解決 HTML 文件操作而設計的,因此語言裡既沒有 byte 型別,也沒有結構化型別,更沒有位元組陣列——就只有數字和字串。

Node 建立在 JavaScript 之上,處理 HTTP 這類文字協定自然游刃有餘。但一旦你要連資料庫、處理圖片、接檔案上傳,只靠字串硬撐就會變得非常痛苦。早期 Node 把位元組編碼成文字字元來繞路,實踐證明這條路走不通:浪費資源、速度慢、不夠靈活,維護起來更是惡夢。

於是 Node 提供了 Buffer 這個二進位緩衝實作。這個「偽類別」包裝了一整套處理原始位元組的 API,把原本繁瑣的任務簡化了不少。緩衝的長度就是位元組數,你可以隨機讀寫其中任一個位置。

值得牢記的是:Buffer 所佔用的記憶體並不配置在 JavaScript VM 的記憶體堆上,因此不受垃圾回收機制管理,而是落在一塊固定且不會被搬移的位址上。這也省下了因緩衝內容搬移而產生的 CPU 消耗。

建立緩衝

用一個 UTF-8 字串就能建立緩衝:

var buf = new Buffer('Hello World!');

也可以指定編碼:

var buf = new Buffer('8b76fde713ce', 'base64');

常見的編碼標識有:

  • ascii:僅適用於 ASCII 字元集。
  • utf8:可變寬編碼,能表示 Unicode 中的任何字元,是 Web 世界的首選,也是 Node 的預設。
  • base64:用 64 個可列印 ASCII 字元表示二進位資料。它常用於把二進位內容嵌進文字文件,需要時又能完整無損地還原。

若沒有初始資料,也可以直接指定容量建立一個空緩衝:

var buf = new Buffer(1024);   // 建立一個 1024 位元組的緩衝

讀取與設定緩衝內容

拿到緩衝物件後,用 [] 運算子就能存取單一位元組:

var buf = new Buffer('my buffer content');

// 存取緩衝中的第 10 個位元組
console.log(buf[10]);   // -> 99

但這裡有個陷阱:用容量大小建立的緩衝,內容並不會被清零,而是殘留的隨機資料。

var buf = new Buffer(1024);

console.log(buf[100]);   // -> 某個隨機值

寫入同樣直覺:

buf[99] = 125;   // 把第 100 個位元組設為 125

另外,某些看起來「不合理」的賦值其實不會丟錯誤,而是靜靜地做些轉換:

  1. 單一位元組的最大值為 255。若賦予超過 255 的數字,會以 256 取模後再寫入。
  2. 因此賦值 256 的實際結果是 0。
  3. 若賦予浮點數(例如 100.7),實際寫入的是整數部分 100。
  4. 若嘗試寫入超出緩衝容量的位置,賦值會失敗,緩衝保持不變。

這些「安靜的失敗」是 bug 的溫床,處理外部資料時最好自己先驗證範圍。

用 length 屬性可以取得長度:

var buf = new Buffer(100);

console.log(buf.length);   // -> 100

有了長度就能迭代整個緩衝:

var buf = new Buffer(100);

for (var i = 0; i < buf.length; i++) {
    buf[i] = i;
}

上面這段建立了一個 100 位元組的緩衝,並把每個位置依序填成 0 到 99。

切分緩衝

若你想從既有緩衝中取出一段,可以用 slice 指定起訖位置:

var buffer = new Buffer("this is the content of my buffer");

var smallerBuffer = buffer.slice(8, 19);

console.log(smallerBuffer.toString());   // -> "the content"

關鍵在於:slice 不會配置或複製任何新記憶體。新緩衝共用父緩衝的記憶體,本質上只是父緩衝某段範圍的參照。這帶來兩個後果。

第一,父子緩衝是不同的 JavaScript 物件,你修改父緩衝的內容,子緩衝跟著變——這件事很違反直覺,容易埋雷。

第二,只要子緩衝還活著,父緩衝物件就不會被回收。若爸媽緩衝很大而你只留了一小塊,記憶體就這樣被釘住了,養成memory leak。

如果你確實需要獨立的一份資料,改用 copy,細節見下。

複製緩衝

copy 可以把一段內容真正複製到另一個緩衝:

var buffer1 = new Buffer("this is the content of my buffer");
var buffer2 = new Buffer(11);

var targetStart = 0;
var sourceStart = 8;
var sourceEnd   = 19;

buffer1.copy(buffer2, targetStart, sourceStart, sourceEnd);

console.log(buffer2.toString());   // -> "the content"

這段程式把來源緩衝的第 9 到 20 個位元組,複製到目標緩衝的起始位置。兩個緩衝自此各自獨立。

解碼緩衝

把緩衝轉成 UTF-8 字串只需要:

var str = buf.toString();

指定編碼參數就能解成其他格式,例如 base64:

var b64Str = buf.toString("base64");

靠著這個方法,UTF-8 轉 base64 也就是兩步而已:

var utf8String = 'my string';
var buf = new Buffer(utf8String);
var base64String = buf.toString('base64');

總結

只要你的應用會碰到二進位資料,Buffer 就是必備工具。它封裝了對連續記憶體區塊的操作,讓你能在兩個緩衝之間切分或複製資料,也能在緩衝與特定編碼字串之間雙向轉換,逐位元組地存取與處理。

實務上有三件事值得養成習慣:建立緩衝後先想清楚內容是否需要初始化、用 slice 時留意共用記憶體帶來的耦合與洩漏風險、寫入前先檢查範圍以免資料被靜默截斷。

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