1. 程式人生 > >nodejs入門之模組

nodejs入門之模組

  • nodejs模組語法與開閉原則
  • nodejs模組的底層實現

 一、nodejs模組語法與開閉原則

關於nodejs模組我在之前的兩篇部落格中都有涉及,但都沒有對nodejs模組的底層做做任何探討,但是為了使相關內容更方便檢視比對理解,這裡還是先引入一下之前兩篇部落格的連線:

js模組化入門與commonjs解析與應用

ES6入門十二:Module(模組化)

1.1 exports、module.exports、require()實現模組匯出匯入:

 1 //示例一:匯出原始值資料
 2 //a.js--用於匯出資料
 3 let a = 123;
 4 module.exports.a=a;
 5 //inde.js--用於匯入a模組的資料
 6 let aModule = require('./a.js');
 7 console.log(aModule.a); //123
 8 
 9 //示例二:匯出引用值資料
10 //a.js--同上
11 function foo(val){ 
12     console.log(val);
13 }
14 module.exports.foo = foo;
15 //index.js--同上
16 let aModule = require('./a.js');
17 let str = "this is 'index' module"
18 aModule.foo(str); //this is 'index' module
19 
20 //示例三:匯出混合資料
21 a.js--同上
22 let a = 123;
23 function foo(val){ 
24     console.log(val);
25 }
26 module.exports = {
27     a:a,
28     foo:foo
29 }
30 //inde.js--同上
31 let aModule = require('./a.js');
32 let str = "this is 'index' module"
33 console.log(aModule.a);//123
34 aModule.foo(str); //this is 'index' module

在上面這些示例中,沒有演示exports的匯出,暫時可以把它看作與同等於module.exports,例如:

 1 //a.js -- 匯出模組
 2 let a = 123;
 3 function foo(val){ 
 4     console.log(val);
 5 }
 6 exports.a = a;
 7 exports.foo = foo;
 8 
 9 //inde.js -- 引用模組a
10 let aModule = require('./a.js');
11 let str = "this is 'index' module"
12 console.log(aModule.a);//123
13 aModule.foo(str); //this is 'index' module

但是使用exports匯出模組不能這麼寫:

 1 //a.js
 2 let a = 123;
 3 function foo(val){ 
 4     console.log(val);
 5 }
 6 exports = {
 7     a:a,
 8     foo:foo
 9 }
10 
11 //index.js
12 let aModule = require('./a.js');
13 let str = "this is 'index' module"
14 console.log(aModule);// {} -- 一個空物件

至於為什麼不能這麼寫,暫時不在這裡闡述,下一節關於nodejs模組底層實現會具體的分析介紹,這裡先來介紹nodejs模組的一個設計思想。

1.2 nodejs模組的開閉原則設計實現

1 //a.js -- 匯出模組
2 let num = 123;
3 let str = "this is module 'a'";
4 exports.a = a;
5 
6 //index.js -- 引用模組a
7 let aModule = require('./a.js');
8 console.log(aModule.num);//123
9 console.log(aModule.str);//undefined

這裡你會發現只有被exports執行了匯出的num成員才能被正常匯出,而str成員沒有被執行匯出,在依賴a.js模組的index.js中是不能引用到a.js模組中的str成員。可能你會說這不是很正常嗎?都沒有匯出怎麼引用呢?

不錯,這是一個非常正常情況,因為語法就告訴了我們,要想引用一個模組的成員就必須先在被引用的模組中匯出該成員。然而這裡要討論的當然不會是匯出與引用這個問題,而是模組給我實現了一個非常友好的設計,假設我現在在a.js中有成員str,在index.js模組中也有成員str,這回衝突嗎?顯然是不會的,即使在a.js中匯出str並且在index.js中引用a.js模組,因為index.js要使用a.js模組的成員str,需要使用接收模組變數aModule.str來使用。

 1 //a.js
 2 let num = 123;
 3 let str = "this is module 'a'";
 4 exports.num = num;
 5 exports.str = str;
 6 
 7 //index.js
 8 let aModule = require('./a.js');
 9 let str = "this is module 'index'"
10 console.log(aModule.num);//123
11 console.log(aModule.str);//this is module 'a'
12 console.log(str);//this is module 'index'

基於開閉原則的設計方式,封閉可以讓模組的內部實現隱藏起來,開放又可以友好的實現模組之間的相互依賴,這相對於之前我們常用的回撥函式解決方案,程式設計變得更清晰,程式碼複用變得更靈活,更關鍵的是還解決了js中一個非常棘手的問題——命名衝突問題,上面的示例就是最好的證明。這裡需要丟擲一個問題,看示例:

1 //下面這種寫法有什麼問題?
2 //a.js
3 let num = 123;
4 module.exports = num;
5 
6 //index.js
7 let aModule = require('./a.js');
8 let str = "this is module 'index'"
9 console.log(aModule);//123

這種寫法不會報錯,也能正常達到目前的需求,如果從能解決目前的功能需求角度來說,它沒錯。但是開閉原則的重要思想就是讓模組保持相對封閉,又有更好的拓展性,這樣寫顯然不合適,比如就上面的程式碼寫完上線以後,業務又出現了一個新的需求需要a.js模組匯出一個成員str,這時候顯然需要同時更改a.js模組和index.js模組,即使新需求不需要index.js來實現也是需要改的。所以維持模組的開閉原則是良好的編碼風格。

 二、nodejs模組的底層實現原理

2.1 module.exports與exports的區別:

//a.js
console.log(module.exports == exports);//true

//然後在控制檯直接執行a.js模組
node a.js

實際上它們是沒有區別的,那為什麼在之前的exports不能直接等於一個物件,而module.exports可以呢?這關乎於js的引用值指向問題:

 

 當export被賦值一個物件時,就發生了一下變化:

這時候我們可以確定node不會匯出exports,因為前面的示例已經說明了這一點,但是值得我們繼續思考的是,node模組是依據module.exports、exports、還是它們指向的初始物件呢?這裡你肯定會說是module.exports,因為前面已經有示例是module.exports指向一個新的物件被成功匯出,但是我並不覺得前面那些示例能說服我,比如下面這種情況:

 1 //a.js模組
 2 let num = 123;
 3 function foo(val){
 4     console.log(val);
 5 }
 6 module.exports = {
 7     num:num
 8 }
 9 exports = {
10     foo:foo
11 }
12 //index.js模組
13 let aModule = require('./a.js');
14 console.log(aModule);//這裡會打印出什麼?

我們現不測試也不猜測,先通過下面的示圖來看下現在的a.js模組中module.exports、exports、以及它們兩初始指向的空物件的關係圖:

 

 這時候我們來看一下index.js執行會輸出什麼?

{ num: 123 }

所以從這個結果可以看出,最後require()最後匯入的是被引用模組的module.exports。探討到這裡的時候並沒有到達node模組的終點,我們這裡module.exports、exports、require()是從哪裡來的?node系統內建變數?還是別的?

2.2 node模組的底層實現原理

這部分的內容其實也沒有太多可以說的,就前面提出來的問題其實有一個方式就可以讓你一目瞭然,只需要在一個js檔案中編寫一下程式碼,然後使用node執行這個js檔案就可以了:

1 console.log(require);      // 一個方法
2 console.log(module);       //  一個物件
3 console.log(exports);      //  一個空物件
4 console.log(__dirname);    //  當前模組所在路徑
5 console.log(__filename);   //  當前檔案的路徑

 這時因為node模組實際上底層是被放到一個立即執行函式內(不要在乎xyz這個名稱,因為我也不知道node底層到底用的什麼名稱),這些變數其實就是這個函式的引數,這個函式大概是一下形式:

1 function xyz(module.exports,require,module,__filename,__dirname){
2     //...
3     //  這裡就是我們在模組中寫入的程式碼
4     //...
5     return module.exports;
6 }

通過上面的推斷就可以得到下面這樣的結果:

1 console.log(module.exports == arguments[0]);//true
2 console.log(require == arguments[1]);//true
3 console.log(module == arguments[2]);//true
4 console.log(__filename == arguments[3]);//true
5 console.log(__dirname == arguments[4]);//true

通過執行這段列印程式碼也確實可以得到這樣的結果,到這裡又有一個值得我們關注的內容,就是每個模組的module引數:

 1 console.log(module);
 2 Module {
 3     id: '.',//當前模組的id都是'.',在後面的parent和children裡面的模組物件上的id就是的對應模組的filename
 4     exports: {},//這裡是模組匯出物件
 5     parent: null,//這裡是當前模組被那些模組引用的模組物件列表,意思是當前模組作為那些模組的父級模組
 6     filename:'',//這裡是當前檔案路徑的絕對路徑
 7     loaded: false,//模組載入狀態,如果在模組內部輸出module物件它永遠都會是false,因為只有這個模組載入完成之後才會被修改成true
 8     children: [
 9         // 這裡是引用模組module物件列表,意思是當前模組作為了那些模組的子模組
10     ],
11     paths:[ 
12         // 這裡是外部模組包的路徑列表,從最近的路徑(模組所在同級路徑)到系統盤路徑所有的node_modules資料夾路徑
13      ] 
14     }

到這裡有可能你還會問為什麼底層實現裡面只有module.exports,沒有export,這個解釋起來真的費勁,下面這一行程式碼幫你搞定:

let exports = module.exports;

這篇部落格主要介紹了node模組的內部內容,並未就node模組基於commonjs規範做任何介紹,是因為在之前的部落格中已經有了非常全面的解析,詳細參考部落格開始時的連線,關於node模組載入相關內容也是在那篇博