stream

stream 是Node.js提供的又一个仅在服务区端可用的模块，目的是支持“流”这种数据结构。

什么是流？流是一种抽象的数据结构。想象水流，当在水管中流动时，就可以从某个地方（例如自来水厂）源源不断地到达另一个地方（比如你家的洗手池）。我们也可以把数据看成是数据流，比如你敲键盘的时候，就可以把每个字符依次连起来，看成字符流。这个流是从键盘输入到应用程序，实际上它还对应着一个名字：标准输入流（stdin）。

如果应用程序把字符一个一个输出到显示器上，这也可以看成是一个流，这个流也有名字：标准输出流（stdout）。流的特点是数据是有序的，而且必须依次读取，或者依次写入，不能像Array那样随机定位。

有些流用来读取数据，比如从文件读取数据时，可以打开一个文件流，然后从文件流中不断地读取数据。有些流用来写入数据，比如向文件写入数据时，只需要把数据不断地往文件流中写进去就可以了。

在Node.js中，流也是一个对象，我们只需要响应流的事件就可以了： 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('ERROR: ' + err);

});

要注意， data 事件可能会有多次，每次传递的 chunk 是流的一部分数据。

要以流的形式写入文件，只需要不断调用 write() 方法，最后以 end() 结束：

'use strict';



var 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.Writable 。