Node.js Stream(流)
Stream 是一个抽象接口,Node 中有很多对象实现了这个接口。例如,对http 服务器发起请求的request 对象就是一个 Stream,还有stdout(标准输出)。
Node.js,Stream 有四种流类型:
- Readable - 可读操作。
- Writable - 可写操作。
- Duplex - 可读可写操作.
- Transform - 操作被写入数据,然后读出结果。
所有的 Stream 对象都是 EventEmitter 的实例。常用的事件有:
- data - 当有数据可读时触发。
- end - 没有更多的数据可读时触发。
- error - 在接收和写入过程中发生错误时触发。
- finish - 所有数据已被写入到底层系统时触发。
从流中获取数据
创建input.txt,内容如下:
我永远喜欢笠笠笠
创建stream.js,内容如下:
// 引入 fs文件系统 模块
const fs = require('fs');
let data = '';
// 创建可读流
const readStream = fs.createReadStream('../input.txt');
// 设置编码为utf-8
readStream.setEncoding('utf-8');
// 处理流事件 => data,end和error
readStream.on('data',function(chunk) {
data += chunk;
})
readStream.on('end',function() {
console.log(data);
})
readStream.on('error',function(err) {
console.log(err.stack);
})
console.log('程序结束');
输出结果为:
程序结束
我永远喜欢笠笠笠
写入流
创建stream.js,内容如下:
const fs = require('fs');
let data = '我永远喜欢笠笠笠';
// 创建一个可以写入的流,写入到input.txt文件中
let writeStream = fs.createWriteStream('../output.txt');
// 使用utf-8编码写入数据
writeStream.write(data,'utf-8');
// 标记文件结尾
writeStream.end();
// 处理流事件 => finish 和 error
writeStream.on('finish',function(chunk) {
console.log('写入结束');
})
writeStream.on('error',function(err) {
console.log(err.stack);
})
console.log('程序执行完毕')
运行结果:可以看到输出的output.txt文件
管道流
管道提供了一个输出流到输入流的机制。通常我们用于从一个流中获取数据并将数据传递到另外一个流中。
以下来读取一个文件中的数据写入到另一个文件中。
先创建input.txt文件,内容如下:
凤兮凤兮归故乡,遨游四海求其凰。
凰兮凰兮从我栖,得托孳尾永为妃。
创建stream.js,内容如下:
const fs = require('fs');
let readStream = fs.createReadStream('../input.txt');
let writeStream = fs.createWriteStream('../output.txt');
// 管道读写操作
// 读取input.txt中的内容,写入到output.txt文件中
readStream.pipe(writeStream);
console.log('程序执行完毕');
执行结果:生成output.txt文件,内容与input.txt文件内容一样
链式流
链式是通过连接输出流到另外一个流并创建多个流操作链的机制。链式流一般用于管道操作。
接下来我们就是用管道和链式来压缩和解压文件。
创建 compress.js文件,内容如下;
const fs = require('fs');
// 引入zlib模块,用来压缩和解压文件
const zlib = require('zlib');
// 压缩 input.txt 文件为 input.txt.gz
fs.createReadStream('../input.txt')
.pipe(zlib.createGzip())
.pipe(fs.createWriteStream('../input.txt.gz'));
console.log('文件压缩完成');
执行结果: 生成压缩文件 input.txt.gz
生成压缩文件之后,下面再来解压缩。创建decompress.js文件,内容如下:
const fs = require('fs');
const zlib = require('zlib');
// 将input.txt.gz 解压为 input.txt
fs.createReadStream('../input.txt.gz')
.pipe(zlib.createGunzip())
.pipe(fs.createWriteStream('../input.txt'));
console.log('程序执行完毕');
执行结果:生成input.txt.gz文件解压为input.txt文件。input.txt.gz压缩文件损坏则会报错。
Node.js模块系统
为了让Node.js的文件可以相互调用,Node.js提供了一个简单的模块系统。
模块是Node.js 应用程序的基本组成部分,文件和模块是一一对应的。换言之,一个 Node.js 文件就是一个模块,这个文件可能是JavaScript 代码、JSON 或者编译过的C/C++ 扩展。
创建模块
先创建一个hello.js文件,内容如下:
// 通过exports对象把world作为模块的访问接口
exports.world = function() {
console.log('我永远喜欢violet');
}
创建main.js,加载hello.js模块:
// 通过require('./hello')来加载这个模块,
let hello = require('./hello');
hello.world();
服务端的模块放在哪里
Node.js 中自带了一个叫做 http 的模块,我们在我们的代码中请求它并把返回值赋给一个本地变量。
这把我们的本地变量变成了一个拥有所有 http 模块所提供的公共方法的对象。
Node.js 的 require 方法中的文件查找策略如下:
由于 Node.js 中存在 4 类模块(原生模块和3种文件模块),尽管 require 方法极其简单,但是内部的加载却是十分复杂的,其加载优先级也各自不同。如下图所示:
从文件模块缓存中加载
尽管原生模块与文件模块的优先级不同,但是都会优先从文件模块的缓存中加载已经存在的模块。
从原生模块加载
原生模块的优先级仅次于文件模块缓存的优先级。require 方法在解析文件名之后,优先检查模块是否在原生模块列表中。以http模块为例,尽管在目录下存在一个 http/http.js/http.node/http.json 文件,require(“http”) 都不会从这些文件中加载,而是从原生模块中加载。
原生模块也有一个缓存区,同样也是优先从缓存区加载。如果缓存区没有被加载过,则调用原生模块的加载方式进行加载和执行。
从文件加载
当文件模块缓存中不存在,而且不是原生模块的时候,Node.js 会解析 require 方法传入的参数,并从文件系统中加载实际的文件,加载过程中的包装和编译细节在前一节中已经介绍过,这里我们将详细描述查找文件模块的过程,其中,也有一些细节值得知晓。
require方法接受以下几种参数的传递:
- http、fs、path等,原生模块。
- ./mod或…/mod,相对路径的文件模块。
- /pathtomodule/mod,绝对路径的文件模块。
- mod,非原生模块的文件模块。