node的可读流基于事件

可读流之流动模式，这种流动模式会有一个"开关"，每次当"开关"开启的时候，流动模式起作用，如果将这个"开关"设置成暂停的话，那么，这个可读流将不会去读取文件，直到将这个"开关"重新置为流动。

读取文件流程

读取文件内容的流程，主要为:

打开文件，打开文件成功，将触发open事件，如果打开失败，触发error事件和close事件，将文件关闭。
开始读取文件中的内容，监听data事件，数据处于流动状态，可通过修改开关的状态来暂停读取。
每次读取到的内容放入缓存中，并通过data事件将数据发布出去。
当文件中的内容读取完毕之后，将文件关闭。

这一系列动作都是基于事件来进行操作的，而node中的事件我们都知道是一种发布订阅模式来实现的。

下面我们来看一看，node是如何使用可读流来读取文件中的内容？

node 可读流参数

首先我们通过fs模块来创建一个可读流，可读流接受两个参数：

第一个参数是要读取的文件地址，在这里指明你要读取哪个文件。
第二个参数是可选项，这个参数是一个对象，用来指定可读流的一些具体的参数。

如下几个参数我们来一一说明：

highWaterMark:设置高水位线，这个参数主要用于在读取文件时，可读流会将文件中的内容读取到缓存当中，而这里我们需要创建一个buffer来缓存这些数据，所以这个参数是用来设置buffer的大小，如果不对这个参数进行设置的话，可读流默认的配置64k。
flags:这个参数主要用于设置文件的执行模式，比如说我们具体的操作适用于读取文件还是写入文件等这些操作。如果是写入文件的话那我们，使用的是w。如果是读取文件的话那这个操作符就应该是r。

下面这张表格就说明了不同的符号代表不同含义：

符号	含义
r	读文件，文件不存在报错
r+	读取并写入，文件不存在报错
rs	同步读取文件并忽略缓存
w	写入文件，不存在则创建，存在则清空
wx	排它写入文件
w+	读取并写入文件，不存在则创建，存在则清空
wx+	和w+类似，排他方式打开
a	追加写入
ax	与a类似，排他方式写入
a+	读取并追加写入，不存在则创建
ax+	作用与a+类似，但是以排他方式打开文件

autoClose:这个参数主要用于，对文件的关闭的一些控制。如果文件再打开的过程或者其他操作的过程中出现了错误的情况下，需要将文件进行关闭。那这个参数是设置文件是否自动关闭的功能。
encoding:node中用buffer来读取文件操作的东西二进制数据。这些数据展现出来的话我们是一堆乱码，所以需要，要我们对这个数据指定一个具体的编码格式。然后将会对这些数据进行编码转化，这样转化出来的数据就是我们能看懂的数据。
starts:这个参数主要用于指定从什么位置开始读取文件中的内容，默认的话是从零开始。
ends:这个参数主要用于指定定具体要读取文件多长的数据，这里需要说明一下，这个参数是包括本身的位置，也就是所谓的包前和包后。

下面我们来看看可读流具体例子：

let fs = require("fs");
let rs = fs.createReadStream("./a.js", {
    highWaterMark: 3,
    encoding: "utf8",
    autoClose: true,
    start: 0,
    end: 9
});
rs.on("open", () => {console.log("open");});
rs.on("close", () => {console.log("close");});
rs.on("data", data => {
    console.log(data);
    rs.pause();//暂停读取 此时流动模式为暂停模式
});
setInterval(() => {
    rs.resume();//重新设置为流动模式，开始读取数据
}, 1000);
rs.on("end", () => { console.log("end"); });
rs.on("error", err => { console.log(err); });

手写可读流第一步

上面我们说过，node可读流是基于node的核心模块事件来完成的，所以在实现我们自己的可读流时需要继承events模块，代码如下：

let fs = require('fs');
let EventEmitter = require('events');
class ReadStream extends EventEmitter {

}

继承了EventEmitter类，我们就可以使用EventEmitter类中的各个方法，并且同样是采用发布订阅的模式了处理事件。

第二步：处理可读流配置的参数

上面我们提到，node中创建可读流时可以对这个流配置具体的参数，比如

let rs = fs.createReadStream("./a.js", {
    highWaterMark: 3,
    encoding: "utf8",
    autoClose: true,
    start: 0,
    end: 9
});

那么对于这些参数，我们自己实现的可读流类也需要对这些参数进行处理，那么这些参数该如何进行处理呢？

constructor(path, options = {}) {
    super();
    this.path = path; //指定要读取的文件地址
    this.highWaterMark = options.highWaterMark || 64 * 1024;
    this.autoClose = options.autoClose || true; //是否自动关闭文件
    this.start = options.start || 0; //从文件哪个位置开始读取
    this.pos = this.start; // pos会随着读取的位置改变
    this.end = options.end || null; // null表示没传递
    this.encoding = options.encoding || null;// buffer编码
    this.flags = options.flags || 'r';

    this.flowing = null; // 模式开关
    this.buffer = Buffer.alloc(this.highWaterMark);// 根据设置创建一个buffer存储读出来的数
    this.open();
}

通常配置的原则是以用户配置的参数为准，如果用户没有对这个参数进行设置的话，就采用默认的配置。

实现可读流第三步：打开文件

这里原理是使用node模块fs中的open方法。首先我们来回顾下fs.open()方法的使用。

fs.open(filename,flags,[mode],callback);
//实例
fs.open('./1,txt','r',function(err,fd){});

这里需要说明下，回调函数callback中有2个参数：

第一个是error，node中异步回调都会返回的一个参数，用来说明具体的错误信息
第二个参数是fd，是文件描述符，用来标识文件，等价于open函数的第一个参数

好了，现在我们来看看我们自己的可读流的open方法该如何实现吧:

open() {
    fs.open(this.path, this.flags, (err, fd) => { 
        //fd标识的就是当前this.path这个文件，从3开始(number类型)
        if (err) {
            if (this.autoClose) { // 如果需要自动关闭则去关闭文件
                this.destroy(); // 销毁(关闭文件，触发关闭事件)
            }
            this.emit('error', err); // 如果有错误触发error事件
            return;
        }
        this.fd = fd; // 保存文件描述符
        this.emit('open', this.fd); // 触发文件的打开的方法
    });
}

从代码上我们可以看出:

fs.open函数是异步函数，也就是说callback是异步执行的，在成功打开文件的情况下，fd这个属性也是异步获取到的，这点需要注意。
另外重要的一点是，如果在打开文件发生错误时，则表明打开文件失败，那么此时就需要将文件关闭。

实现可读流第四步：读取文件内容

上面我们详细说过，可读流自身定义了一个"开关"，当我们要读取文件中的内容的时候，我们需要将这个"开关"打开，那么node可读流本身是如何来打开这个"开关"的呢？

监听data事件

node可读流通过监听data事件来实现这个"开关"的开启:

rs.on("data", data => {
    console.log(data);
});

当用户监听data事件的时候，"开关"开启，不停的从文件中读取内容。那么node是怎么监听data事件的呢？答案就是 事件模块的newListener

这是因为node可读流是基于事件的，而事件中，服务器就可以通过newListener事件监听到从用户这边过来的所有事件，每个事件都有对应的类型，当用户监听的是data事件的时候，我们就可以获取到，然后就可以去读取文件中的内容了，那我们自己的可读流该如何实现呢？

// 监听newListener事件，看是否监听了data事件，如果监听了data事件的话，就开始启动流动模式，读取文件中的内容
this.on("newListener", type => {
    if (type === "data") {
        //  开启流动模式，开始读取文件中的内容
        this.flowing = true;
        this.read();
    }
});

好了，知道了这个"开关"是如何打开的，那么这个时候就到了真正读取文件中内容的关键时候了，先上代码先：

read() {
    // 第一次读取文件的话，有可能文件是还没有打开的，此时this.fd可能还没有值
    if (typeof this.fd !== "number") {
        // 如果此时文件还是没有打开的话，就触发一次open事件，这样文件就真的打开了，然后再读取
        return this.once("open", () => this.read());
    }
    // 具体每次读取多少个字符，需要进行计算,因为最后一次读取倒的可能比highWaterMark小
    let howMuchRead = this.end ? Math.min(this.end - this.pos + 1, this.highWaterMark) : this.highWaterMark;
    fs.read(this.fd, this.buffer, 0, howMuchRead, this.pos, (err, byteRead) => {
        // this.pos 是每次读取文件读取的位置，是一个偏移量，每次读取会发生变化
        this.pos += byteRead;
        // 将读取到的内容转换成字符串串，然后通过data事件，将内容发布出去
        let srr = this.encoding ? this.buffer.slice(0, byteRead).toString(this.encoding) : this.buffer.slice(0, byteRead);
        // 将内容通过data事件发布出去
        this.emit("data", srr);
        // 当读取到到内容长度和设置的highWaterMark一致的话，并且还是流动模式的话，就继续读取
        if ((byteRead === this.highWaterMark) && this.flowing) {
            return this.read();
        }
        // 没有更多的内容了，此时表示文件中的内容已经读取完毕
        if (byteRead < this.highWaterMark) {
            // 读取完成，发布end方法，并关闭文件
            this.emit("end");
            this.destory();
        }
    });
}

这里我们特别要注意的是：

文件是否已经打开，是否获取到fd，如果没有打开的话，则再次触发open方法
分批次读取文件内容，每次读取的内容是变化的，所以位置和偏移量是要动态计算的
控制读取停止的条件。

实现可读流第五步：关闭文件

好了，到现在，基础的读取工作已经完成，那么就需要将文件关闭了，上面的open和read方法里面都调用了一个方法：destory，没错，这个就是关闭文件的方法，好了，那么我们来看看这个方法该如何实现吧

destory() {
    if (typeof this.fd !== "number") {
        // 发布close事件
        return this.emit("close");
    }
    // 将文件关闭，发布close事件
    fs.close(this.fd, () => {
        this.emit("close");
    });
}

当然这块的原理就是调用fs模块的close方法啦。

实现可读流第六步：暂停和恢复

既然都说了，node可读流有一个神奇的"开关"，就像大坝的阀门一样，可以控制水的流动，同样也可以控制水的暂停啦。当然在node可读流中的暂停是停止对文件的读取，恢复就是将开关打开，继续读取文件内容，那么这两个分别对应的方法就是pause()和resume()方法。

那么我们自己的可读流类里面该如何实现这两个方法的功能呢？非常简单：我们在定义类的私有属性的时候，定义了这样一个属性flowing，当它的值为true时表示开关打开，反之关闭。

pause() {
    this.flowing = false;// 将流动模式设置成暂停模式，不会读取文件
}
resume() {
    this.flowing = true;//将模式设置成流动模式，可以读取文件
    this.read();// 重新开始读取文件
}

好了，关于node可读流的实现我们就写到这里，快快敲起代码，动手实现一个你自己的可读流吧！