1.模塊定義
nodejs所謂的模塊就是一個文件!一個.js文件就是一個nodejs的模塊,模塊與文件是一一對應的,那麼引用模塊就是require('文件路徑')。
如:
var circle = require('./circle.js');
console.log( 'The area of a circle of radius 4 is '
+ circle.area(4));
這個取名爲foo.js
var PI = Math.PI;
exports.area = function (r) {
return PI * r * r;
};
exports.circumference = function (r) {
return 2 * PI * r;
};
這個取名爲circle.js
兩個js代碼文件是放在同一個文件夾下的。
如果你要引用其它文件夾下的模塊,直接寫定路徑。這裏的路徑格式和linux的路徑格式一樣:/../../.js 這是絕對路徑,../.js 這個是上一層 ./.js 這個就是當前路徑。
這裏需要注意exports與module.exports的區別:exports其實只是module.exports的一個引用(就像a=2,b=a這樣,b只是引用了a,當b=c的時候,b就不指向a了),這樣就能明白官網上的意思了(如果你想要將exports的根聲明爲一個函數,或者你想生成一個object,那麼就請用module.exports而不是exports)
2.循環引用
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');
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');
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);
看到沒有,這個a.js與b.js兩個相互引用了。這樣會不會無限循環呢?不會的,這只是會有一個沒有加載完畢,也就是有一個module一部分處於不可用狀態。像這裏,a.js先加載,但是在加載a.js的同時,a.js加載了b.js,此時a.js處於停滯狀態,只是僅僅加載了require前面的數據,而對於b.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
3.核心模塊
所謂核心模塊,其實就是nodejs開發的公共包,就像java的公共包一樣。訪問核心模塊只要require('文件名字'),這樣就能訪問到。其實公共模塊包是放在了nodejs安裝的node_modules\npm\lib下面。
4.文件模塊
當沒有精確匹配所謂的引用時,nodejs會先採用擴展名:.js
, .json
,
and then .node
. .js文件就是javascript文件,.json就會以json格式解析,.node就會以dlopen加載爲一個附加的模塊
這裏還需要注意,當沒有'/'、'./'這樣的符號修飾時,模塊加載的地方是在node_modules,至於這個文件在哪,請看下面。
5.node_modules文件夾
如果在引用模塊時沒有'/' '../' './'這樣的格式符號限定,那麼其採用尋找的方式如下:假設你的文件在'/home/ry/projects/foo.js',其引用了require('bar.js'),那麼這個bar.js尋找方式如下:
/home/ry/projects/node_modules/bar.js
/home/ry/node_modules/bar.js
/home/node_modules/bar.js
/node_modules/bar.js
require('example-module/path/to/file')這種引用和require('bar.js')是一樣的解析。
6.以文件夾名字引用模塊
大致分爲兩種:1)寫package.json文件,此文件寫在項目的根目錄下,其形式如下:
{ "name" : "some-library",
"main" : "./lib/some-library.js" }
這樣寫出來的require('./some-library')其真正的是
require('./some-library/lib/some-library.js')
2)直接約定好爲index.js或index.node文件加載,同上的require,其加載可能如下:
./some-library/index.js
./some-library/index.node
一個模塊的多次引用會只做一次加載。就像java中的static關鍵字修飾。不過要值得注意的是,當你require('foo')這樣的形式就不一定保證每次都會引用到相同的文件了(因爲你可能會在不同的文件夾中引用)。