Node.js 模組系統

Node.js模組系統

為了讓Node.js的檔案可以相互呼叫，Node.js提供了一個簡單的模組系統。

模組是Node.js 應用程式的基本組成部分，檔案和模組是一一對應的。換言之，一個 Node.js 檔案就是一個模組，這個檔案可能是JavaScript 程式碼、JSON 或者編譯過的C/C++ 擴充套件。

引入模組

在 Node.js 中，引入一個模組非常簡單，如下我們建立一個 main.js 檔案並引入 hello 模組，程式碼如下:

var hello = require('./hello');
hello.world();

以上例項中，程式碼 require('./hello') 引入了當前目錄下的 hello.js 檔案（./ 為當前目錄，node.js 預設字尾為 js）。

Node.js 提供了 exports 和 require 兩個物件，其中 exports 是模組公開的介面，require 用於從外部獲取一個模組的介面，即所獲取模組的 exports 物件。

接下來我們就來建立 hello.js 檔案，程式碼如下：

exports.world = function() {
  console.log('Hello World');
}

在以上示例中，hello.js 通過 exports 物件把 world 作為模組的訪問介面，在 main.js 中通過 require('./hello') 載入這個模組，然後就可以直接訪問 hello.js 中 exports 物件的成員函數了。

有時候我們只是想把一個物件封裝到模組中，格式如下：

module.exports = function() {
  // ...
}

例如:

//hello.js 
function Hello() { 
    var name; 
    this.setName = function(thyName) { 
        name = thyName; 
    }; 
    this.sayHello = function() { 
        console.log('Hello ' + name); 
    }; 
}; 
module.exports = Hello;

這樣就可以直接獲得這個物件了：

//main.js 
var Hello = require('./hello'); 
hello = new Hello(); 
hello.setName('BYVoid'); 
hello.sayHello();

模組介面的唯一變化是使用 module.exports = Hello 代替了exports.world = function(){}。在外部引用該模組時，其介面物件就是要輸出的 Hello 物件本身，而不是原先的 exports。

服務端的模組放在哪裡

也許你已經注意到，我們已經在程式碼中使用了模組了。像這樣：

var http = require("http");

...

http.createServer(...);

Node.js 中自帶了一個叫做 http 的模組，我們在我們的程式碼中請求它並把返回值賦給一個本地變數。

這把我們的本地變數變成了一個擁有所有 http 模組所提供的公共方法的物件。

Node.js 的 require 方法中的檔案查詢策略如下：

由於 Node.js 中存在 4 類模組（原生模組和3種檔案模組），儘管 require 方法極其簡單，但是內部的載入卻是十分複雜的，其載入優先順序也各自不同。如下圖所示：

從檔案模組快取中載入

儘管原生模組與檔案模組的優先順序不同，但是都會優先從檔案模組的快取中載入已經存在的模組。

從原生模組載入

原生模組的優先順序僅次於檔案模組快取的優先順序。require 方法在解析檔名之後，優先檢查模組是否在原生模組列表中。以http模組為例，儘管在目錄下存在一個 http/http.js/http.node/http.json 檔案，require("http") 都不會從這些檔案中載入，而是從原生模組中載入。

原生模組也有一個快取區，同樣也是優先從快取區載入。如果快取區沒有被載入過，則呼叫原生模組的載入方式進行載入和執行。

從檔案載入

當檔案模組快取中不存在，而且不是原生模組的時候，Node.js 會解析 require 方法傳入的引數，並從檔案系統中載入實際的檔案，載入過程中的包裝和編譯細節在前一節中已經介紹過，這裡我們將詳細描述查詢檔案模組的過程，其中，也有一些細節值得知曉。

require方法接受以下幾種引數的傳遞：

http、fs、path等，原生模組。
./mod或../mod，相對路徑的檔案模組。
/pathtomodule/mod，絕對路徑的檔案模組。
mod，非原生模組的檔案模組。

在路徑 Y 下執行 require(X) 語句執行順序：

1. 如果 X 是內建模組
   a. 返回內建模組
   b. 停止執行
2. 如果 X 以 '/' 開頭
   a. 設定 Y 為檔案根路徑
3. 如果 X 以 './' 或 '/' or '../' 開頭
   a. LOAD_AS_FILE(Y + X)
   b. LOAD_AS_DIRECTORY(Y + X)
4. LOAD_NODE_MODULES(X, dirname(Y))
5. 丟擲異常 "not found"

LOAD_AS_FILE(X)
1. 如果 X 是一個檔案, 將 X 作為 JavaScript 文字載入並停止執行。
2. 如果 X.js 是一個檔案, 將 X.js 作為 JavaScript 文字載入並停止執行。
3. 如果 X.json 是一個檔案, 解析 X.json 為 JavaScript 物件並停止執行。
4. 如果 X.node 是一個檔案, 將 X.node 作為二進位制外掛載入並停止執行。

LOAD_INDEX(X)
1. 如果 X/index.js 是一個檔案,  將 X/index.js 作為 JavaScript 文字載入並停止執行。
2. 如果 X/index.json 是一個檔案, 解析 X/index.json 為 JavaScript 物件並停止執行。
3. 如果 X/index.node 是一個檔案,  將 X/index.node 作為二進位制外掛載入並停止執行。

LOAD_AS_DIRECTORY(X)
1. 如果 X/package.json 是一個檔案,
   a. 解析 X/package.json, 並查詢 "main" 欄位。
   b. let M = X + (json main 欄位)
   c. LOAD_AS_FILE(M)
   d. LOAD_INDEX(M)
2. LOAD_INDEX(X)

LOAD_NODE_MODULES(X, START)
1. let DIRS=NODE_MODULES_PATHS(START)
2. for each DIR in DIRS:
   a. LOAD_AS_FILE(DIR/X)
   b. LOAD_AS_DIRECTORY(DIR/X)

NODE_MODULES_PATHS(START)
1. let PARTS = path split(START)
2. let I = count of PARTS - 1
3. let DIRS = []
4. while I >= 0,
   a. if PARTS[I] = "node_modules" CONTINUE
   b. DIR = path join(PARTS[0 .. I] + "node_modules")
   c. DIRS = DIRS + DIR
   d. let I = I - 1
5. return DIRS

exports 和 module.exports 的使用

如果要對外暴露屬性或方法，就用 exports 就行，要暴露物件(類似class，包含了很多屬性和方法)，就用 module.exports。

入門教學 -- 學的不僅是技術，更是夢想！