Node.js 的module 系统

　　相较于原生的JavaScript，不同的JavaScript文件之间很难共享变量。有鉴于此，Node.js在JavaScript的基础上进行了扩充，引入了require，exports，module三个global object。

一、absolute module 和 relative module

　　Smashing Node.js 的作者将node.js 中的modules 分成了两类，一类是absolute modules，一类是 relative modules。

　　<1> absolute modules，指的是是node core自带的重要modules，如http，fs等，我们使用这些modules时，只需要 require(‘module_name’)即可；还包括用npm安装的第三方module，这些module 默认安装的位置是./node_modules/ 路径下，使用这些modules时，同样只需要require(‘module_name’)即可。但是，在package.json文件中要添加这些module的name，以便使用npm安装。

　　<2> relative modules，指的是我们自己写的modules，这些modules一般存在于工程文件夹内部，引用时我们需要以require(‘相对路径/module_name’)的方式引用。相对路径，指的是这些modules相对工程文件夹的存放的位置。

　　注意：即使自己编写的modules位于package.json相同的位置，也需要使用require('./module_name')来引用，否则会按照第一种方式寻找且出错。

　　通过这些modules，我们可以将复杂的node.js javascript代码分割在不同的文件中，简化我们的工程的管理与维护。

 

　　每个module中的变量，除了用exports或者module.exports 声明的属性，都是局部变量，只用用于本模块内。 

 

二、什么是require？

 

Modules are cached after the first time they are loaded. This means (among other things) that every call to require('foo') will get exactly the same object returned, if it would resolve to the same file.

Multiple calls to require('foo') may not cause the module code to be executed multiple times. This is an important feature. With it, "partially done" objects can be returned, thus allowing transitive dependencies to be loaded even when they would cause cycles.

If you want to have a module execute code multiple times, then export a function, and call that function.

　　这里的require，跟我们普通的理解的加载不一样，除了把被加载模块的通过module.exports 导出的object或者function放到执行环境中去，也会在加载的过程中执行这个模块的其他代码，因为js是解释型语言，语意上是一句一句执行的。

　　node.js 使用require引入模块时，会历经以下四个步骤。由于核心模块已经被编译执行过，所以核心模块只会执行第四步。对于用户编写的非核心模块，以下四步都会执行。所以，如果模块内有需要执行的js语句，会在第一次require的时候执行。

• 路径分析
• 文件定位
• 编译执行
• 加入内存

　　由于node.js 的缓存机制，每个模块都只会被加载一次，也即执行一次，即使多次require。如要想这个module的代码被多次执行，要将这些代码放到function中去，并通过module.exports 引出。

　　<1> 简单的require

module_a.js

1 name_a = 'a'; //全局作用域
var a = 'a';  //执行作用域仅限于 module_a.js中
console.log(name_a);  //第一次require的时候执行。
//console.log(name_b);//会出错，name_b未定义

module_b.js

1 name_b ='b'
console.log(name_b);

main.js

1 require('./module_a'); //relative module，需要给出module的路径, module_a除了被导出的object，未被导出的代码也会被执行。
require('./module_b');
//console.log(a); --> 出错，不能访问未被引出来的模块变量。
console.log(name_a);
console.log(name_b);

<2> circular require

　　circular require：顾名思义，循环导入，a.js 要导入b.js, 同理b.js 也要导入a.js。我们先看一下官方给出的例子

filename: a.js

console.log('a starting');
exports.done = false;
var b = require('./b.js');
console.log('in a, b.done = %j', b.done);
exports.done = true;
console.log('a done');

filename: b.js


console.log('b starting');
exports.done = false;
var a = require('./a.js');
console.log('in b, a.done = %j', a.done);
exports.done = true;
console.log('b done');

filename: main.js

console.log('main starting');
var a = require('./a.js');
var b = require('./b.js');
console.log('in main, a.done=%j, b.done=%j', a.done, b.done);

When main.js loads a.js, then a.js in turn loads b.js. At that point, b.js tries to load a.js. In order to prevent an infinite loop an unfinished copy of the a.js exports object is returned to the b.js module. b.js then finishes loading, and its exports object is provided to the a.js module.

　　当main.js 加载a.js的时候，a.js 又会加载b.js。b.js加载的过程中又会尝试加载a.js。为了防止陷入无限的循环之中，b.js会直接引用已经加载但是还没有完全加载的a.js(require ('b.js') 之前的代码)。当b.js加载并执行完成后，a.js才会接着加载执行，然后main.js加载执行。

测试结果

$ node main.js
main starting
a starting
b starting
in b, a.done = false
b done
in a, b.done = true
a done
in main, a.done=true, b.done=true

 

三、module.exports和exports

　　每一个模块(js文件)都有一个局部变量：module，这个module指向当前的模块。这个module有多个成员field，其中一个就是module.exports。module.exports 是一个javascript object，会被引出，返回给通过require加载的模块。所以我们只需要把要返回的object或者function赋给module.exports，就可以返回任意我们想要返回的object或者function了。

　　

　<1> 什么时候该用exports，什么时候该用module.exports

 1 The exports variable that is available within a module starts as a reference to module.exports.
 As with any variable, if you assign a new value to it, it is no longer bound to the previous value.
 2 
 3 
 4 function require(...) {
 5   // ...
 6   function (module, exports) {
 7     // Your module code here
 8     exports = some_func;        // re-assigns exports, exports is no longer
 9                                 // a shortcut, and nothing is exported.
10     module.exports = some_func; // makes your module export 0
11   } (module, module.exports);
12   return module;
13 }
14 
15 As a guideline, if the relationship between exports and module.exports seems like magic to you, ignore exports and only use module.exports.

　　上面是摘抄自官方的关于exports和module.exports 的解释。 exports就是模块内对module.exports 的一个引用，所以我们给这个引用增加任何的属性(exports.field = value)，最后在其他模块require的时候都可以访问到。

　　但是如果给直接给exports 赋予某个object(exports = object)，试图返回一个object的话,是不能通过exports来返回的，因为 exports = object这个过程就会把exports的指向给改变，不再指向module.exports。而我们用require 加载的object是module.exports 指向的object。

 

　　<2> 通过exports 返回对象的实例：

　　默认，每个module通过exports返回一个空的对象实例，我们可以通过给该module的exports增加属性来改变该module返回的对象实例。

module_a.js

exports.name = ‘john’;  
4 exports.data = ‘this is some data’;
var privateVariable = 5;
exports.getPrivate = function () {
return privateVariable;
};

index.js

var a = require(‘./module_a’);  //注意，exports默认返回的是一个已经创建好的对象实例，所以可以直接调用属性，而不需要new。
console.log(a.name);
console.log(a.data);
console.log(a.getPrivate());

<3> 通过module.exports 返回constructor 函数：

　　虽然通过module.exports可以传递创建好的对象实例，但有时候我们希望在传递时能控制这个对象的创建过程，此时我们需要传递constructor函数：

module.exports = Person;

function Person(name){
    this.name = name; 
}

Person.prototype.talk = function() {
    console.log('my name is ', this.name);
}

var Person = require(‘./person’);
var john = new Person(‘john’);　//Person 为constructor函数，必须new之后才能使用
john.talk();