stream是仅在服务器端可用的模块,目的是支持流这种数据结构
流的特点是数据有序,而且必须是依次读取或者依次写入,不能像数组那样随机定位,有标准输入流和标准输出流
在Nodejs中,流是一个对象,我们只需要响应流的事件就可以了,data事件 表示流已经可以读取了,end事件表示这个流已经到末尾了,没有数据可以读取了,error事件表示出错了
'use strict'
//下面是一个从文件流读取文本内容的示例
var fs = require('fs');
//打开一个流
var rs = fs.createReadStream('sample.txt','utf-8');
rs.on('data',function(chunk){
console.log('DATA:');
console.log(chunk);
});
rs.on('end',function(){
console.log('end');
});
rs.on('error',function(err){
console.log(err);
});
要注意,data事件可能会有多次,每次传递的chunk是流的一部分是数据;
要以流的形式写入文件,只需要不断调用write()方法,最后以end结束
fs = require('fs');
var ws1 = fs.createWriteStream('output1.txt','utf-8');
ws1.write('使用Stream写入文本数据....\n');
ws1.write('end');
ws1.end();
var ws2 = fs.createWriteStream('output2.txt');
ws2.write(new Buffer('使用Stream写入二进制数据...\n','utf-8'))
ws2.write(new Buffer('END','utf-8'));
ws2.end();
所有可以读取数据的流都继承自Stream.Readable,所有可以写入的流都集成Stream.Writeable
pipe
管子,运输;把一个可读的流Readable和一个可写的流Writeable串起来后,所有的数据自动从Readable流入到Writeable流
这种操作叫pipe
在Node.js中，Readable流有一个pipe()方法，就是用来干这件事的。
让我们用pipe()把一个文件流和另一个文件流串起来，这样源文件的所有数据就自动写入到目标文件里了，所以，这实际上是一个复制文件的程序：
var fs = require('fs');
var rs = fs.createReadStream('sample.txt');
var ws = fs.createWriteStream('copied,txt');
rs.pipe(ws);
默认情况下,当readable流的数据读取完毕,end事件触发后,将自动关闭Writeable流,如果我们不希望自动关闭Writeable流,需要传入参数:
rs.pipe(ws,{end:false})
