新聞中心
穩(wěn)定性: 3 - 文檔本節(jié)介紹node.js中ZLIB模塊的使用,你可以通過以下方式訪問這個(gè)模塊:

var zlib = require('zlib');這個(gè)模塊提供了對(duì)Gzip/Gunzip, Deflate/Inflate, 和 DeflateRaw/InflateRaw類的綁定。每個(gè)類都有相同的參數(shù)和可讀/寫的流。
例子
壓縮/解壓縮一個(gè)文件,可以通過倒流(piping)一個(gè)fs.ReadStream到zlib流里來,再到一個(gè)fs.fs.WriteStream:
var gzip = zlib.createGzip();
var fs = require('fs');
var inp = fs.createReadStream('input.txt');
var out = fs.createWriteStream('input.txt.gz');
inp.pipe(gzip).pipe(out);一步壓縮/解壓縮數(shù)據(jù)可以通過一個(gè)簡(jiǎn)便方法來實(shí)現(xiàn)。
var input = '.................................';
zlib.deflate(input, function(err, buffer) {
if (!err) {
console.log(buffer.toString('base64'));
}
});
var buffer = new Buffer('eJzT0yMAAGTvBe8=', 'base64');
zlib.unzip(buffer, function(err, buffer) {
if (!err) {
console.log(buffer.toString());
}
});要在一個(gè)HTTP客戶端或服務(wù)器中使用這個(gè)模塊,可以在請(qǐng)求時(shí)使用accept-encoding,響應(yīng)時(shí)使用content-encoding頭。
注意: 這些例子只是簡(jiǎn)單展示了基本概念。Zlib編碼可能消耗非常大,并且結(jié)果可能要被緩存。更多使用 zlib 相關(guān)的速度/內(nèi)存/壓縮的權(quán)衡選擇細(xì)節(jié)參見后面的Memory Usage Tuning。
// client request example
var zlib = require('zlib');
var http = require('http');
var fs = require('fs');
var request = http.get({ host: 'izs.me',
path: '/',
port: 80,
headers: { 'accept-encoding': 'gzip,deflate' } });
request.on('response', function(response) {
var output = fs.createWriteStream('izs.me_index.html');
switch (response.headers['content-encoding']) {
// or, just use zlib.createUnzip() to handle both cases
case 'gzip':
response.pipe(zlib.createGunzip()).pipe(output);
break;
case 'deflate':
response.pipe(zlib.createInflate()).pipe(output);
break;
默認(rèn):
response.pipe(output);
break;
}
});
// server example
// Running a gzip operation on every request is quite expensive.
// It would be much more efficient to cache the compressed buffer.
var zlib = require('zlib');
var http = require('http');
var fs = require('fs');
http.createServer(function(request, response) {
var raw = fs.createReadStream('index.html');
var acceptEncoding = request.headers['accept-encoding'];
if (!acceptEncoding) {
acceptEncoding = '';
}
// Note: this is not a conformant accept-encoding parser.
// See http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.3
if (acceptEncoding.match(/\bdeflate\b/)) {
response.writeHead(200, { 'content-encoding': 'deflate' });
raw.pipe(zlib.createDeflate()).pipe(response);
} else if (acceptEncoding.match(/\bgzip\b/)) {
response.writeHead(200, { 'content-encoding': 'gzip' });
raw.pipe(zlib.createGzip()).pipe(response);
} else {
response.writeHead(200, {});
raw.pipe(response);
}
}).listen(1337);
zlib.createGzip([options])
根據(jù)參數(shù)options返回一個(gè)新的Gzip對(duì)象。
zlib.createGunzip([options])
根據(jù)參數(shù)options返回一個(gè)新的Gunzip對(duì)象。
zlib.createDeflate([options])
根據(jù)參數(shù)options返回一個(gè)新的Deflate對(duì)象。
zlib.createInflate([options])
根據(jù)參數(shù)options返回一個(gè)新的Inflate對(duì)象。
zlib.createDeflateRaw([options])
根據(jù)參數(shù)options返回一個(gè)新的DeflateRaw對(duì)象。
zlib.createInflateRaw([options])
根據(jù)參數(shù)options返回一個(gè)新的InflateRaw對(duì)象。
zlib.createUnzip([options])
根據(jù)參數(shù)options返回一個(gè)新的Unzip對(duì)象。
Class: zlib.Zlib
這個(gè)類未被zlib模塊導(dǎo)出。之所以寫在這,是因?yàn)檫@是壓縮/解壓縮類的基類。
zlib.flush([kind], callback)
參數(shù)kind默認(rèn)為zlib.Z_FULL_FLUSH。
刷入緩沖數(shù)據(jù)。不要輕易調(diào)用這個(gè)方法,過早的刷會(huì)對(duì)壓縮算法產(chǎn)生負(fù)面影響。
zlib.params(level, strategy, callback)
動(dòng)態(tài)更新壓縮基本和壓縮策略。僅對(duì)deflate算法有效。
zlib.reset()
重置壓縮/解壓縮為默認(rèn)值。僅適用于inflate和deflate算法。
Class: zlib.Gzip
使用gzip壓縮數(shù)據(jù)。
Class: zlib.Gunzip
使用gzip解壓縮數(shù)據(jù)。
Class: zlib.Deflate
使用deflate壓縮數(shù)據(jù)。
Class: zlib.Inflate
解壓縮deflate流。
Class: zlib.DeflateRaw
使用deflate壓縮數(shù)據(jù),不需要拼接zlib頭。
Class: zlib.InflateRaw
解壓縮一個(gè)原始deflate流。
Class: zlib.Unzip
通過自動(dòng)檢測(cè)頭解壓縮一個(gè)Gzip-或Deflate-compressed流。
簡(jiǎn)便方法
所有的這些方法第一個(gè)參數(shù)為字符串或緩存,第二個(gè)可選參數(shù)可以供zlib類使用,回調(diào)函數(shù)為callback(error, result)。
每個(gè)方法都有一個(gè)*Sync伴隨方法,它接收相同參數(shù),不過沒有回調(diào)。
zlib.deflate(buf[, options], callback)
zlib.deflateSync(buf[, options])
使用Deflate壓縮一個(gè)字符串。
zlib.deflateRaw(buf[, options], callback)
zlib.deflateRawSync(buf[, options])
使用DeflateRaw壓縮一個(gè)字符串。
zlib.gzip(buf[, options], callback)
zlib.gzipSync(buf[, options])
使用Gzip壓縮一個(gè)字符串。
zlib.gunzip(buf[, options], callback)
zlib.gunzipSync(buf[, options])
使用Gunzip解壓縮一個(gè)原始的Buffer。
zlib.inflate(buf[, options], callback)
zlib.inflateSync(buf[, options])
使用Inflate解壓縮一個(gè)原始的Buffer。
zlib.inflateRaw(buf[, options], callback)
zlib.inflateRawSync(buf[, options])
使用InflateRaw解壓縮一個(gè)原始的Buffer。
zlib.unzip(buf[, options], callback)
zlib.unzipSync(buf[, options])
使用Unzip解壓縮一個(gè)原始的Buffer。
Options
每個(gè)類都有一個(gè)選項(xiàng)對(duì)象。所有選項(xiàng)都是可選的。
注意:某些選項(xiàng)僅在壓縮時(shí)有用,解壓縮時(shí)會(huì)被忽略。
- flush (默認(rèn):
zlib.Z_NO_FLUSH) - chunkSize (默認(rèn):16*1024)
- windowBits
- level (僅壓縮有效)
- memLevel (僅壓縮有效)
- strategy (僅壓縮有效)
- dictionary (僅 deflate/inflate 有效, 默認(rèn)為空字典)
參見deflateInit2和inflateInit2的描述,它們位于http://zlib.net/manual.html#Advanced。
使用內(nèi)存調(diào)優(yōu)
來自zlib/zconf.h,修改為node's的用法:
deflate的內(nèi)存需求(單位:字節(jié)):
(1 << (windowBits+2)) + (1 << (memLevel+9))windowBits=15的128K加memLevel = 8的128K (缺省值),加其他對(duì)象的若干KB。
例如,如果你想減少默認(rèn)的內(nèi)存需求(從256K減為128k),設(shè)置選項(xiàng):
{ windowBits: 14, memLevel: 7 }當(dāng)然這通常會(huì)降低壓縮等級(jí)。
inflate的內(nèi)存需求(單位:字節(jié)):
1 << windowBitswindowBits=15(默認(rèn)值)32K 加其他對(duì)象的若干KB。
這是除了內(nèi)部輸出緩沖外chunkSize的大小,默認(rèn)為16K。
影響zlib的壓縮速度最大因素為level壓縮級(jí)別。level越大,壓縮率越高,速度越慢,level越小,壓縮率越小,速度會(huì)更快。
通常來說,使用更多的內(nèi)存選項(xiàng),意味著node必須減少對(duì)zlib掉喲過,因?yàn)榭梢栽谝粋€(gè)write操作里可以處理更多的數(shù)據(jù)。所以,這是另一個(gè)影響速度和內(nèi)存使用率的因素,
常量
所有常量定義在zlib.h ,也定義在require('zlib') 。
通常的操作,基本用不到這些常量。寫到文檔里是想你不會(huì)對(duì)他們的存在感到驚訝。這個(gè)章節(jié)基本都來自zlibdocumentation。更多細(xì)節(jié)參見http://zlib.net/manual.html#Constants。
允許flush的值:
zlib.Z_NO_FLUSHzlib.Z_PARTIAL_FLUSHzlib.Z_SYNC_FLUSHzlib.Z_FULL_FLUSHzlib.Z_FINISHzlib.Z_BLOCKzlib.Z_TREES
壓縮/解壓縮函數(shù)的返回值。負(fù)數(shù)代表錯(cuò)誤,正數(shù)代表特殊但正常的事件:
zlib.Z_OKzlib.Z_STREAM_ENDzlib.Z_NEED_DICTzlib.Z_ERRNOzlib.Z_STREAM_ERRORzlib.Z_DATA_ERRORzlib.Z_MEM_ERRORzlib.Z_BUF_ERRORzlib.Z_VERSION_ERROR
壓縮級(jí)別:
zlib.Z_NO_COMPRESSIONzlib.Z_BEST_SPEEDzlib.Z_BEST_COMPRESSIONzlib.Z_DEFAULT_COMPRESSION
壓縮策略:
zlib.Z_FILTEREDzlib.Z_HUFFMAN_ONLYzlib.Z_RLEzlib.Z_FIXEDzlib.Z_DEFAULT_STRATEGY
data_type字段的可能值:
zlib.Z_BINARYzlib.Z_TEXTzlib.Z_ASCIIzlib.Z_UNKNOWN
deflate的壓縮方法:
zlib.Z_DEFLATED
初始化zalloc, zfree, opaque:
zlib.Z_NULL
文章題目:創(chuàng)新互聯(lián)Node.js教程:Node.jsZLIB
文章出自:http://fisionsoft.com.cn/article/djhidgs.html


咨詢
建站咨詢
