1.CommonJS规范的起因
1.JavaScript没有模块系统。没有原生的支持密闭作用域或依赖管理。
2.JavaScript没有标准库。除了一些核心库外,没有文件系统的API,没有IO流API等。
3.JavaScript没有标准接口。没有如Web Server或者数据库的统一接口。
4.JavaScript没有包管理系统。不能自动加载和安装依赖。
2.CommonJS对模块的定义十分简单,主要分为模块引用、模块定义和模块标识3个部分。
1.模块引用
require('xxx')
2.模块定义
exports.xxx
module.exports = {}
3.模块标识
模块标识其实就是传递给require()方法的参数,它必须是符合小驼峰命名的字符串,
或者以.、..开头的相对路径,或者绝对路径。它可以没有文件名后缀.js。
3.Nodejs模块分类
Node.js的模块分为两类,一类为核心模块(node提供),一类为文件模块(用户编写)。核心模块在Node.js源代码编译的时候编译进了二进制执行文件,在nodejs启动过程中,部分核心模块直接加载进了内存中,所以这部分模块引入时可以省略文件定位和编译执行两个步骤,所以加载的速度最快。另一类文件模块是动态加载的,加载速度比核心模块慢。但是Node.js对核心模块和文件模块都进行了缓存,于是在第二次require时,是不会有重复开销的。其中原生模块都被定义在lib这个目录下面,文件模块则不定性。
ps:核心模块又分为两部分,C/C++编写的和Javascript编写的,前者在源码的src目录下,后者则在lib目录下。(lib/*.js)(其中lib/internal部分不提供给文件模块)
注:通过process.moduleLoadList可以查看已经加载的核心模块。 核心模块 = 原生模块
4.模块引入三步走
1.路径分析
2.文件定位
3.编译执行
1.路径分析
核心模块:如http、fs、path等,速度仅次于缓存。
路径形式的文件:以.或者..开始的相对路径,以/开始的绝对路径。
自定义模块:不属于核心模块也不属于路径形式的标识符。它是一种特殊的文件模块,可能是一个文件或者包的形式。这类模块的查找是最费时的,也是所有方式中最慢的一种。在定位时,会给出一个可能路径的数组
没有mac电脑,直接copy阮老师的图 http://www.ruanyifeng.com/blo...
关键源码
https://github.com/nodejs/nod...
lib/module.js开头就使用了require,略蒙蔽?不要着急,这个js文件中的reuiqre与我们平常使用的是不一样的,此处的require其实是NativeModule.require。而NativeModule的定义在https://github.com/nodejs/nod...
node在启动的时候会去执行bootstrap_node.js这个模块,后续会对此进行分析,暂时只需明白module.js中的require与我们文件模块中使用的require不是同一个即可
路径分析代码追踪栈
Module.prototype.require --> Module._load --> Module._resolveFilename --> Module._resolveLookupPaths --> Module._findPath(文件定位) --> fileName(文件绝对路径)
几个方法的作用小结:
Module.prototype.require:直接调用Module._load并return
Module._load:调用Module._resolveFilename获取文件绝对路径,并且根据该绝对路径添加缓存以及编译模块
Module._resolveFilename:获取文件绝对路径
Module._resolveLookupPaths:获取文件可能路径
Module._findPath:根据文件可能路径定位文件绝对路径,包括后缀补全(.js, .json, .node)等都在此方法中执行,最终返回文件绝对路径
Module.prototype.require = function(path) {
assert(path, 'missing path');
assert(typeof path === 'string', 'path must be a string');
return Module._load(path, this, /* isMain */ false);
};
Module._load = function(request, parent, isMain) {
if (parent) {
debug('Module._load REQUEST %s parent: %s', request, parent.id);
}
var filename = Module._resolveFilename(request, parent, isMain);
// 检测缓存
var cachedModule = Module._cache[filename];
if (cachedModule) {
updateChildren(parent, cachedModule, true);
return cachedModule.exports;
}
// 检测是否是核心模块
if (NativeModule.nonInternalExists(filename)) {
debug('load native module %s', request);
return NativeModule.require(filename);
}
// Don't call updateChildren(), Module constructor already does.
var module = new Module(filename, parent);
// 判断是否是入口模块
if (isMain) {
process.mainModule = module;
module.id = '.';
}
// 添加缓存(小碎步,由于缓存在模块编译前就进行了设置,解决了循环依赖的问题!!!)
Module._cache[filename] = module;
// 编译模块
tryModuleLoad(module, filename);
return module.exports;
};
Module._resolveFilename = function(request, parent, isMain) {
// 判断是否是核心模块
if (NativeModule.nonInternalExists(request)) {
return request;
}
// 计算所有可能的路径,对于核心模块,相对路径,绝对路径,自定义模块返回不同的数组
var paths;
paths = Module._resolveLookupPaths(request, parent, true);
// look up the filename first, since that's the cache key.
// 计算文件的绝对路径
var filename = Module._findPath(request, paths, isMain);
if (!filename) {
var err = new Error(`Cannot find module '${request}'`);
err.code = 'MODULE_NOT_FOUND';
throw err;
}
return filename;
};
// 暴露给文件模块的文件定位方法
require.resolve = function(request) {
return Module._resolveFilename(request, self);
};
// 用法
require.resolve('a.js')
// 返回 /home/ruanyf/tmp/a.js
Module._resolveLookupPaths代码相对复杂,这里简单起见只展示一些其执行结果
tt.js文件目录d/wedoctor
node tt.js
console.log(module.constructor._resolveLookupPaths('fs', module, true))
console.log(module.constructor._resolveLookupPaths('/hello', module, true))
console.log(module.constructor._resolveLookupPaths('../../hello', module, true))
console.log(module.constructor._resolveLookupPaths('hello', module, true))
1.加载核心模块的时候,返回 null
2.加载绝对路径的时候,返回
[ 'D:\\wedoctor\\node_modules',
'D:\\node_modules',
'C:\\Users\\小韩\\.node_modules',
'C:\\Users\\小韩\\.node_libraries',
'D:\\tools\\nodejs\\lib\\node' ]
由于是绝对路径,所以在_findPath方法中会被清空
3.加载相对路径的时候,返回
[ 'D:\\wedoctor' ]
4.加载自定义模块的时候,返回
[ 'D:\\wedoctor\\node_modules',
'D:\\node_modules',
'C:\\Users\\小韩\\.node_modules',
'C:\\Users\\小韩\\.node_libraries',
'D:\\tools\\nodejs\\lib\\node' ]
上面的数组,就是模块所有可能的路径。基本上是,从当前路径开始一级级向上寻找 node_modules 子目录。
最后那三个路径,主要是为了历史原因保持兼容,实际上已经很少用了。
Module._findPath = function(request, paths) {
// 列出所有可能的后缀名:.js,.json, .node
var exts = Object.keys(Module._extensions);
// 如果是绝对路径,就不再搜索
if (request.charAt(0) === '/') {
paths = [''];
}
// 是否有后缀的目录斜杠
var trailingSlash = (request.slice(-1) === '/');
// 第一步:如果当前路径已在缓存中,就直接返回缓存
var cacheKey = JSON.stringify({request: request, paths: paths});
if (Module._pathCache[cacheKey]) {
return Module._pathCache[cacheKey];
}
// 第二步:依次遍历所有路径
for (var i = 0, PL = paths.length; i < PL; i++) {
var basePath = path.resolve(paths[i], request);
var filename;
if (!trailingSlash) {
// 第三步:是否存在该模块文件
filename = tryFile(basePath);
if (!filename && !trailingSlash) {
// 第四步:该模块文件加上后缀名,是否存在
filename = tryExtensions(basePath, exts);
}
}
// 第五步:目录中是否存在 package.json
if (!filename) {
filename = tryPackage(basePath, exts);
}
if (!filename) {
// 第六步:是否存在目录名 + index + 后缀名
filename = tryExtensions(path.resolve(basePath, 'index'), exts);
}
// 第七步:将找到的文件路径存入返回缓存,然后返回
if (filename) {
Module._pathCache[cacheKey] = filename;
return filename;
}
}
// 第八步:没有找到文件,返回false
return false;
};
至此在看_load方法中,以及获取到的文件的绝对地址fileName,以此判断缓存,是否是核心模块,如果两者都不是,则进行模块编译tryModuleLoad。继续看tryModuleLoad方法
function tryModuleLoad(module, filename) {
var threw = true;
// 调用了module.load方法
try {
module.load(filename);
threw = false;
} finally {
if (threw) {
delete Module._cache[filename];
}
}
}
Module.prototype.load = function(filename) {
debug('load %j for module %j', filename, this.id);
assert(!this.loaded);
this.filename = filename;
this.paths = Module._nodeModulePaths(path.dirname(filename));
var extension = path.extname(filename) || '.js';
if (!Module._extensions[extension]) extension = '.js';
// 根据不同的文件后缀名,调用不同的方法
Module._extensions[extension](this, filename);
this.loaded = true;
};
// Native extension for .js
Module._extensions['.js'] = function(module, filename) {
var content = fs.readFileSync(filename, 'utf8');
module._compile(internalModule.stripBOM(content), filename);
};
// Native extension for .json
Module._extensions['.json'] = function(module, filename) {
var content = fs.readFileSync(filename, 'utf8');
try {
module.exports = JSON.parse(internalModule.stripBOM(content));
} catch (err) {
err.message = filename + ': ' + err.message;
throw err;
}
};
以js为例最终调用module._compile方法
Module.prototype._compile = function (content, filename) {
content = internalModule.stripShebang(content);
// 添加函数包裹
var wrapper = Module.wrap(content);
// 把字符串转换成可用函数
var compiledWrapper = vm.runInThisContext(wrapper, {
filename: filename,
lineOffset: 0,
displayErrors: true
});
// 通过call方法,使模块内部this指向module.exports对象,同时将一些方法作为参数传入模块中
result = compiledWrapper.call(this.exports, this.exports, require, this, filename, dirname);
return result;
};
Module.wrapper = [
'(function (exports, require, module, __filename, __dirname) { ',
'\n});'
];
接下来还需要分析,NativeModule是如何注入到module.js中的,NativeModule又是如何加载核心模块的?
NativeModule代码在源码目录lib/internal/bootstrap_node.js中
bootstrap_node.js在node启动中被调用,并且注入c++对象process,bootstrap_node.js 中会对process 进行部分信息初始化,其实这只是很少的一部分,大部分都在 c++ 部分初始化的。
在node.cc文件中我们可以发现process对象初始化代码
之前我们讲到,nodejs源码中Javascript编写的核心模块都会通过V8附带的js2c.py工具转换成C++里面的数组,生成node_natives.h头文件。
当调用process.binding('natives')时候,该方法将通过js2c.py工具转换出的字符串数组取出,然后重新转换为普通字符串,以对Javascript核心模块进行编译和执行。
继续在该文件中我们可以看到
在lib/module.js也是实现被v8工具转换成c++数组,所以通过NativeModule.require('module')对module模块进行编译执行,并且获取module模块导出的Module对象,在执行该对象的runMain函数,回过头来我们看module.js
原来当我们在命令行执行 node app.js时候 app.js就是process.argv[1],而Module._load这个方法之前就介绍过了。回头来,在Node真正执行app.js之前,做了许多前置工作,包括process对象注入,核心模块的加载等。
参考:
https://github.com/nodejs/nod...
https://github.com/nodejs/nod...
http://www.ruanyifeng.com/blo...
http://f2e.souche.com/blog/a-...
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。