概述

常见的自定义流有四种,Readable(可读流)、Writable(可写流)、Duplex(双工流)和 Transform(转换流),常见的自定义流应用有 HTTP 请求、响应,crypto 加密,进程 stdin 通信等等。

流相关文章推荐:

stream 模块介绍

Node.js 中要想实现自定义流,需要依赖模块 stream,直接引入,不需下载,所有种类的流都是继承这个模块内部提供的对应不同种类的类来实现的。

实现一个自定义可读流 Readable

创建自定义可读流的类 MyRead

我们创建一个名为 MyRead 的自定义可读流,并继承 stream 中的 Readable 类,重写 _read 方法,重写核心方法是实现自定义流的套路。

/* 创建自定义可读流 */
const { Readable } = require('stream');

// 创建自定义可读流的类
class MyRead extends Readable {
  constructor() {
    super();
    this.index = 0;
  }

  // 重写自定义的可读流的 _read 方法
  _read() {
    this.index++;
    this.push(this.index + '');

    if (this.index === 3) {
      this.push(null);
    }
  }
}

我们自己写的 _read 方法会继承很多流原有的特性,比如在读取时使用 push 方法将数据读取出来,直到 push 的值为 null 才会停止,否则会认为没有读取完成,会继续调用 _read

验证自定义可读流

/* 验证自定义可读流 */
const myRead = new MyRead();

myRead.on('data', data => {
  console.log(data);
});

myRead.on('end', function () {
  console.log('读取完成');
});

// <Buffer 31>
// <Buffer 32>
// <Buffer 33>
// 读取完成

实现一个自定义可写流 Writable

创建自定义可写流的类 MyWrite

创建一个名为 MyWrite 的自定义可写流,并继承 stream 中的 Writable 类,重写 _write 方法。

/* 创建自定义可写流 */
const { Writable } = require('stream');

// 创建自定义可写流的类
class MyWrite extends Writable {
  // 重写自定义的可写流的 _write 方法
  _write(chunk, encoding, callback)) {
    callback(); // 将缓存区写入文件
  }
}

写入内容时默认第一次写入直接写入文件,后面的写入都写入缓存区,如果不调用 callback 只能默认第一次写入文件,调用 callback 会将缓存区清空并写入文件。

验证自定义可写流

/* 验证自定义可写流 */
const myWrite = new MyWrite();

myWrite.write('hello', 'utf8', () => {
  console.log('hello ok');
});

myWrite.write('world', 'utf8', () => {
  console.log('world ok');
});

// hello ok
// world ok

实现一个自定义双工流 Duplex

创建自定义可双工流的类 MyDuplex

双工流的可以理解为即可读又可写的流,创建一个类名为 MyDuplex,并继承 stream 中的 Duplex 类,由于双工流即可读又可写,需重写 _read_write 方法。

/* 创建自定双工流 */
const { Duplex } = require('stream');

// 创建自定义双工流的类
class MyDuplex extends Duplex {
  // 重写自定义的双工流的 _read 方法
  _read() {
    this.push('123');
    this.push(null);
  }

  // 重写自定义的双工流的 _write 方法
  _write(chunk, encoding, callback)) {
    callback();
  }
}

双工流分别具备 ReadableWritable 的功能,但是读和写互不影响,互不关联。

验证自定义双工流

/* 验证自定义双工流 */
const myDuplex = new MyDuplex();

myDuplex.on('readable', () => {
  console.log(myDuplex.read(1), '----');
});

setTimeout(() => {
  myDuplex.on('data', data => {
    console.log(data, 'xxxx');
  });
}, 3000);

// <Buffer 31> ----
// <Buffer 32> xxxx
// <Buffer 32> ----
// <Buffer 33> xxxx

如果 readabledata 两种读取方式都使用默认先通过 data 事件读取,所以一般只选择一个,不要同时使用,可读流的特点是读取数据被消耗掉后就丢失了(缓存区被清空),如果非要两个都用可以加一个定时器(绝对不要这样写)。

实现一个自定义转化流 Transform

创建自定义可转化流的类 MyTransform

转化流的意思是即可以当作可读流,又可以当作可写流,与双工流的区别是读和写可以相关联,创建一个类名为 MyTransform,并继承 stream 中的 Transform 类,重写 _transform 方法,该方法的参数和 _write 相同。

/* 创建自定义转化流 */
const { Transform } = require('stream');

// 创建自定义转化流的类
class MyTransform extends Transform {
  // 重写自定义的转化流的 _transform 方法
  _transform(chunk, encoding, callback)) {
    console.log(chunck.toString.toUpperCase());
    callback();
    this.push('123');
  }
}

在自定义转化流的 _transform 方法中,读取数据的 push 方法和 写入数据的 callback 都可以使用。

由此可以看出,Transform 类型可以将可读流转化为可写流,也可以将可写流转化成可读流,他的主要目的不是像其他类型的流一样负责数据的读写,而是既作为可读流又作为可写流,实现流的转化,即实现对数据的特殊处理,如 zib 模块实现的压缩流,cropo 模块实现的加密流,本质都是转化流,将转化流作为可写流,将存储文件内容的可写流通过 pipe 方法写入转化流,再将转化流作为可读流通过 pipe 方法将处理后的数据响应给浏览器。

验证自定义转化流

/* 验证自定义转化流 */
const myTransForm = new MyTransform();

// 使用标准输入
process.stdin.pipe(myTransForm).pipe(process.stdin);

打开命令行窗口执行 node demo.js,然后输入 abc,会在命令窗口输出 ABC123,其实转换流先作为一个可写流被写入到标准输入中,而此时 stdin 的作用是读流,即读取用户的输入,读取后转换流作为一个可读流调用 pipe,将用户输入的信息通过标准输出写到命令行窗口,此时 stdout 的作用是写流。

总结

自定义流最常见的种类在上面都已经涵盖了,真正的在开发中用到的不多,如果需要写一个自定义流应该比上面的复杂很多,本文主要目的是认识什么是自定义流,并了通过 Node.js 解实现一个自定义流的基本流程。