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 文件，内容如下：

w3cschool教程官网地址：www.w3cschool.cn

创建 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("程序执行完毕");

以上代码执行结果如下：

程序执行完毕
w3cschool教程官网地址：www.w3cschool.cn

写入流

创建 main.js 文件, 代码如下：

var fs = require("fs");
var data = 'w3cschool教程官网地址：www.w3cschool.cn';

// 创建一个可以写入的流，写入到文件 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 
w3cschool教程官网地址：www.w3cschool.cn

管道流

管道提供了一个输出流到输入流的机制。通常我们用于从一个流中获取数据并将数据传递到另外一个流中。

代码执行结果如下：

$ node main.js 
程序执行完毕

查看 output.txt 文件的内容：

$ cat output.txt 
w3cschool教程官网地址：www.w3cschool.cn
管道流操作实例

链式流

链式是通过连接输出流到另外一个流并创建多个对个流操作链的机制。链式流一般用于管道操作。

接下来我们就是用管道和链式来压缩和解压文件。

创建 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 
文件解压完成。