Node.js Stream
Stream 是 Node.js 中非常重要的模块,应用广泛。
Stream 是抽象接口,Node 中有很多对象实现了这个接口。例如,对http 服务器发起请求的request 对象就是 Stream,还有stdout(标准)。
该抽象接口是可读、可写或是既可读又可写的,通过这些接口,我们可以和磁盘、字、HTTP请求来交互,实现数据从地方流动到另地方的。
Node.js,Stream 有四种流类型:
Readable - 可读操作。
Writable - 可写操作。
Duplex - 可读可写操作.
Transform - 操作被写入数据,然后读出结果。
所有的 Stream 对象都是 EventEmitter 的实例。常用的事件有:
data - 当有数据可读时触发。
end - 没有更多的数据可读时触发。
error - 在接收和写入过程中发生时触发。
finish - 所有数据已被写入到底层系统时触发。
本教程会为大家介绍常用的流操作。
从流中读取数据
创建 input.txt ,如下:
前端之家官网地址:www.f2er.com
创建 main.js , 如下:
var fs = require("fs"); var data = ''; // 创建可读流 var readerStream = fs.createReadStream('input.txt'); // 设置编码为 utf8。 readerStream.setEncoding('UTF8'); // 处理流事件 --> data, end, and error readerStream.on('data', function(chunk) { data += chunk; }); readerStream.on('end',function(){ console.log(data); }); readerStream.on('error', function(err){ console.log(err.stack); }); console.log("程序执行完毕");
以上执行结果如下:
程序执行完毕 前端之家官网地址:www.f2er.com
写入流
创建 main.js , 如下:
var fs = require("fs"); var data = '前端之家官网地址:www.f2er.com'; // 创建可以写入的流,写入到 output.txt 中 var writerStream = fs.createWriteStream('output.txt'); // 使用 utf8 编码写入数据 writerStream.write(data,'UTF8'); // 末尾 writerStream.end(); // 处理流事件 --> data, end, and error writerStream.on('finish', function() { console.log("写入完成。"); }); writerStream.on('error', function(err){ console.log(err.stack); }); console.log("程序执行完毕");
以上程序会将 data 变量的数据写入到 output.txt 中。执行结果如下:
$ node main.js 程序执行完毕 写入完成。
查看 output.txt 的:
$ cat output.txt 前端之家官网地址:www.f2er.com
管道流
管道提供了流到输入流的机制。通常我们用于从流中数据并将数据传递到另外流中。
如上面的所示,我们把比作装水的桶,而水就是里的,我们用一根管子(pipe)连接两个桶使得水从桶流入另桶,这样就慢慢的实现了大的复制过程。
以下实例我们通过读取并将写入到另外中。
设置 input.txt 如下:
前端之家官网地址:www.f2er.com 管道流操作实例
创建 main.js , 如下:
var fs = require("fs"); // 创建可读流 var readerStream = fs.createReadStream('input.txt'); // 创建可写流 var writerStream = fs.createWriteStream('output.txt'); // 管道读写操作 // 读取 input.txt ,并将写入到 output.txt 中 readerStream.pipe(writerStream); console.log("程序执行完毕");
执行结果如下:
$ node main.js 程序执行完毕
查看 output.txt 的:
$ cat output.txt 前端之家官网地址:www.f2er.com 管道流操作实例
链式流
链式是通过连接流到另外流并创建多个对个流操作链的机制。链式流一般用于管道操作。
接下来我们就是用管道和链式来压缩和解压。
创建 compress.js , 如下:
var fs = require("fs"); var zlib = require('zlib'); // 压缩 input.txt 为 input.txt.gz fs.createReadStream('input.txt') .pipe(zlib.createGzip()) .pipe(fs.createWriteStream('input.txt.gz')); console.log("压缩完成。");
执行结果如下:
$ node compress.js 压缩完成。
执行完以上操作后,我们可以看到当前目录下了 input.txt 的压缩 input.txt.gz。
接下来,让我们来解压该,创建 decompress.js ,如下:
var fs = require("fs"); var zlib = require('zlib'); // 解压 input.txt.gz 为 input.txt fs.createReadStream('input.txt.gz') .pipe(zlib.createGunzip()) .pipe(fs.createWriteStream('input.txt')); console.log("解压完成。");
执行结果如下:
$ node decompress.js 解压完成。