Node.js躬行记（1）——Buffer、流和EventEmitter

一、Buffer

　　Buffer是一种Node的内置类型，不需要通过require()函数额外引入。它能读取和写入二进制数据，常用于解析网络数据流、文件等。

1）创建

　　通过new关键字初始化Buffer对象的方式已经被废弃，下面的代码都已经过时。

new Buffer(array)
new Buffer(arrayBuffer[, byteOffset[, length]])
new Buffer(buffer)
new Buffer(size)
new Buffer(string[, encoding])

　　目前有两种方式创建Buffer对象，第一种是通过alloc()或allocUnsafe()两个静态方法，语法如下。

Buffer.alloc(size[, fill[, encoding]])
Buffer.allocUnsafe(size)

　　alloc()方法可接收三个参数，后两个是可选的。第一个参数是长度，第二个参数是预填充的值，第三个参数是字符编码，默认值是“utf8”。

const buf1 = Buffer.alloc(10);
const buf2 = Buffer.alloc(10, "A");
const buf3 = Buffer.alloc(10, "A", "ascii");

　　如果打印buf3，那么得到的将是一组十六进制数据，而非难以阅读的二进制数据，如下所示。

<Buffer 41 41 41 41 41 41 41 41 41 41>

　　注意，Buffer的大小在创建时确定，后面也无法更改，其类型可由Buffer.isBuffer()辨别。当前Node支持的字符编码有6种：

　　（1）ascii：仅适用于7位的ASCII数据。

　　（2）utf8：多字节编码的Unicode字符。许多网页和其它文档格式都在使用UTF-8。

　　（3）utf16le/ucs2：2或4个字节，小端序编码的Unicode字符。支持代理对（U+10000至U+10FFFF）。

　　（4）base64：Base64编码，一种基于64个可打印字符来表示二进制数据的表示方法。

　　（5）latin1/binary：一种可编码成单字节字符串的方法。

　　（6）hex：将每个字节编码成两个十六进制的字符。

　　allocUnsafe()是一个不安全的方法，因为它分配的内存片段是未初始化的，即没有被清零。虽然这种设计性能优越，但分配的内存中可能会包含旧数据。

　　第二种是通过Buffer.from()方法创建Buffer对象，它的参数可以是数组、字符串、Buffer对象等，如下所示。

const buf = Buffer.from("A");
console.log(buf);        //<Buffer 41>

2）转换编码

　　在读取文件时，可通过toString()方法将Buffer对象转换成字符串，如下所示，默认是UTF-8格式。

const fs = require('fs');
fs.readFile('./demo.txt', (err, buf) => {
  buf.toString();            　　//"你好，Node.js"
  buf.toString("base64");       //"5L2g5aW977yMTm9kZS5qcw=="
});

二、流

　　Node中的stream模块用于处理流式数据，许多内置的核心模块都在其内部实现了流操作，流还适用于网络传输、JSON解析器、RFC（远程调用）等。流包括四个抽象类：

　　（1）Readable：可读流，读取底层的I/O数据源。

　　（2）Writeable：可写流，将数据写入到目标中。

　　（3）Duplex：双工流，即可读也可写。

　　（4）Transform：转换流，会修改数据的双工流。

1）pipe()

　　在可读流中，包含一个管道方法：pipe()，它的作用是关联可读流与可写流，让数据通过管道从可读流进入到可写流中。pipe()方法能接收一个Writable对象，并返回对目标流的引用，从而可形成链式调用。

　　在下面的示例中，会将origin.txt中的数据通过管道写入到target.txt文件中，调用文件模块的createReadStream()方法能得到一个Readable对象。

const fs = require('fs');
const readable = fs.createReadStream('./origin.txt');
const writable = fs.createWriteStream('./target.txt');
readable.pipe(writable);

2）事件

　　以可读流为例，它的data事件可在接收到数据块后触发，而end事件会在流没有数据时触发。在下面的示例中，origin.txt文件包含的内容是“hello Node.js”。

const fs = require('fs');
const readable = fs.createReadStream('./origin.txt', {highWaterMark: 2});
readable.on("data", (chunk) => {
  console.log(`接收到 ${chunk.length} 个字节的数据`, chunk.toString());
});
readable.on("end", () => {
  console.log("结束接收");
});

　　在调用createReadStream()方法时，包含一个highWaterMark属性，其默认值为64KB，它的作用是限制可缓冲的字节数。当定义为2后，每接收2个字节的数据，就会触发data事件，打印结果如下所示。

接收到 2 个字节的数据 he
接收到 2 个字节的数据 ll
接收到 2 个字节的数据 o
接收到 2 个字节的数据 No
接收到 2 个字节的数据 de
接收到 2 个字节的数据 .j
接收到 1 个字节的数据 s
结束接收

　　可读流还包含一个error事件，用于监听异常，其事件处理程序会接收一个Error对象。在下面的示例中，会读取不存在的文件，从而触发error事件。

const readable = fs.createReadStream('./demo.txt');
readable.on("error", (err) => {
  console.log(err);        //打印错误信息
});

3）实现流

　　当实现自定义的流时，需要继承四个抽象类中的一个，表1列出了四个抽象类需要实现的方法。

抽象类	需要实现的方法
Readable	_read()
Writeable	_write()、_writev()、_final()
Duplex	_read()、_write()、_writev()、_final()
Transform	_transform()、_flush()、_final()

　　下面是一个自定义可写流的例子，_write()方法中的encoding是一个字符串，表示字符编码。

const { Writable } = require('stream');
class MyWritable extends Writable {
  constructor(options) {
    super(options);
  }
  _write(chunk, encoding, callback) {
    if (encoding === "buffer") {
      callback();
    }
  }
}

三、EventEmitter

　　Node的事件模块目前只包含一个EventEmitter类（即事件触发器），所有能触发事件的对象都是EventEmitter类的实例。EventEmitter通常被用作基类，在Node内部，凡是提供事件机制的模块都会继承它。

　　在下面的示例中，声明了一个EventEmitter实例，on()方法用于注册监听器，emit()方法用于触发事件。在调用emit()方法时，传递了自定义的type参数。

const EventEmitter = require('events');
class MyEmitter extends EventEmitter {}
const myEmitter = new MyEmitter();

myEmitter.on('click', (type) => {
  console.log(`触发${type}事件`);
});
myEmitter.emit('click', "点击");

　　注意，可注册多个相同名称的事件，监听器会按照添加顺序依次调用。事件模块还提供了很多其它方法，例如off()用于解除事件绑定，once()可以只监听一次事件。