Node.js的模块系统是借鉴 CommonJS 的 Modules 规范实现的,因此,下面我们需要先了解 CommonJS 的 Modules 规范,希望对大家学习Node.js有所帮助。
CommonJS 的 Modules 规范
CommonJS 对模块的定义非常简单,主要分为 模块引用、模块定义和模块标识三个部分。
1. 模块引用 - require() 方法
2. 模块定义 - module.exports 对象
3. 模块标识 - 传递给 require() 方法的参数
通过 CommonJS 的这套导出和引入机制,用户不必再考虑变量污染的问题。
Node 的模块实现
Node 中的模块分为两类:
1. Node 提供的模块 - 核心模块
2. 用户编写的模块 - 文件模块
核心模块:
1. 在 Node 源代码的编译过程中,编译进了二进制文件
2. 在 Node 进程启动时,部分核心模块被直接加载近内存
文件模块:
1. 运行时动态加载,需要完整的路径分析、文件定位、编译执行过程
Node 缓存
Node 对引入过的模块都会进行缓存,Node 缓存的是编译执行之后的对象,require() 方法对相同模块的加载一律采用缓存优先的方式,这是第一优先级。
路径分析和文件定位
模块标识符分析
模块标识符,就是传入 require() 方法的参数,对于不同的模块标识符,查找和定位的方式是不一样的。
模块标识在 Node 中主要分为以下几类:
· 核心模块(http、fs、path .etc),加载优先级仅次于缓存加载,其加载过程最快
· . 或 .. 开头的相对路径,都会被当做文件模块处理, require() 方法会将路径转换为真实路径,并以真实的路径作为索引,将编译执行后的结果存放到缓存中
· / 开始的绝对路径,同上
· 非路径开始的文件模块,它不是核心模块,但是又不写成路径的形式,这类的查找是最费时的,详细的分析在下文
模块路径
在了解自定义模块的查找方式之前,需要先知道 模块路径 这个概念。
模块路径 是 Node 在定位文件模块的具体文件是制定的查找策略,具体表现为一个路径组成的数组。
模块路径 的生成规则如下:
· 当前目录下的 node_modules 目录
· 父目录下的 node_modules 目录
· 父目录的父目录下的 node_modules 目录
· 一直到系统的根目录下的 node_modules 目录
在加载的过程中,Node 会逐个尝试模块路径中的路径,知道找到目标文件为止
文件定位
Node 在定位好文件之后,还需要做一些事情,包括:扩展名的分析以及目录、包的处理
扩展名的分析:如果标识符不包含扩展名,Node 会按 .js .json .node 的次序补充扩展名,依次尝试
目录、包的处理:如果通过标识符没找到对应文件,但是找到了同名的一个目录
1. 首先,Node 会在该目录下查找 package.json 文件,从中取出 main 属性指定的文件名对应
2. 如果 package.json 的 main 属性指定的文件名错误或者是直接没有 package.json 文件,Node 会将 index 作为默认文件名
3. 如果在目录分析的过程中没有定位成功任何的文件,则自定义模块进入下一个模块路径进行搜索,如果路径数组已经遍历完了还没找到目标文件则会抛出一个异常
模块编译
编译和执行是引入文件模块的最后一个阶段,在 Node 中,每个文件都是一个模块,定义如下
function Module(id, parent){
this.id = id
this.exports = {}
this.parent = parent
if (parent && parent.children) {
parent,children.push(this)
}
this.filename = null
this.loaded = false
this.children = []
}
定位到具体的文件后,Node 会新建一个模块对象,然后根据载入路径载入并编译。
载入
不同文件的载入方法是不同的:
· .js 文件:通过 fs 模块同步读取模块后编译执行
· .node 文件:通过 dlopen() 方法加载最后编译生成的文件
· .json 文件:通过 fs 模块同步读取文件后,通过 JSON.parse() 解析返回结果
· 其余扩展名文件
Module._extensions 会被赋值给 require() 的 extensions 属性,如果想对自定义的扩展名进行特殊的加载,可以通过类似 require.extension[’.coffee’] 扩展的方式来实现。
编译
JavaScript 模块的编译
一个正常的 JavaScript 文件会被包装成如下的样子:
(function (exports, require, module, __filename, __dirname){
// 文件里本来的 js 代码
})
module.exports 对象上的任何方法和属性都可以被外部调用到。
C/C++ 模块的编译
Node 调用
process.dlopen() 方法进行加载和执行。
JSON 文件的编译
Node 利用 fs 模块同步读取 .json 文件,调用 JSON.parse() 方法得到对象然后赋值给 module.exports
每一个编译成功的模块都会将其文件路径作为索引缓存在 Module._chche 对象上。
核心模块
Node 的核心模块在编译成可执行文件的过程中被编译进了二进制文件。核心模块分为 C/C++ 和 JavaScript 编写的两个部分
JavaScript 核心模块的编译过程
第一步:转存为 C/C++ 代码
1. Node 采用 V8 附带的 js2c.py 工具将所有内置的 JavaScript 代码转换成 C++ 里的数组
2. 在这个过程中,JavaScript 代码以字符串的形式存储在 node 命名空间中,是不可执行的
3. 在启动 Node 进程时,JavaScript 代码直接加载进内存中
4. 在加载的过程中,JavaScript 核心模块经历标识符分析后直接定位到内存中
第二步:编译 JavaScript 核心模块
与文件模块有区别的地方在于:获取源代码的方式(核心模块是从内存中加载的)和缓存( NativeModule._cache )执行结果的位置。
C/C++ 核心模块的编译过程
由纯 C/C++ 编写的部分统称为内建模块,因为他它们通常不被用户直接调用。Node 的 buffer、crypto、evals、fs、os 等模块都是内建模块。
… 这个坑先留着
内建模块的导出
Node 在启动时,会生成一个全局变量 process ,并提供 Binding() 方法来协助加载内建模块。
前面提到的 JavaScript 核心文件被转换为 C/C++ 数组存储后,便是通过 process.binding(’natives’) 取出放置在 NativeModule._source 中的:
NativeModule._source = process.binding(’natives’)
来源:Mertens Notes