Node.js Domain 模塊

Node.js 工具模塊Node.js 工具模塊

Node.js Domain(域) 簡(jiǎn)化異步代碼的異常處理，可以捕捉處理try catch無(wú)法捕捉的異常。引入 Domain 模塊 語(yǔ)法格式如下：

var domain = require("domain")

domain模塊，把處理多個(gè)不同的IO的操作作為一個(gè)組。注冊(cè)事件和回調(diào)到domain，當(dāng)發(fā)生一個(gè)錯(cuò)誤事件或拋出一個(gè)錯(cuò)誤時(shí)，domain對(duì)象會(huì)被通知，不會(huì)丟失上下文環(huán)境，也不導(dǎo)致程序錯(cuò)誤立即推出，與process.on('uncaughtException')不同。

Domain 模塊可分為隱式綁定和顯式綁定：

  • 隱式綁定: 把在domain上下文中定義的變量，自動(dòng)綁定到domain對(duì)象
  • 顯式綁定: 把不是在domain上下文中定義的變量，以代碼的方式綁定到domain對(duì)象

方法

序號(hào)方法 & 描述
1domain.run(function)
在域的上下文運(yùn)行提供的函數(shù)，隱式的綁定了所有的事件分發(fā)器，計(jì)時(shí)器和底層請(qǐng)求。
2domain.add(emitter)
顯式的增加事件
3domain.remove(emitter)
刪除事件。
4domain.bind(callback)
返回的函數(shù)是一個(gè)對(duì)于所提供的回調(diào)函數(shù)的包裝函數(shù)。當(dāng)調(diào)用這個(gè)返回的函數(shù)被時(shí)，所有被拋出的錯(cuò)誤都會(huì)被導(dǎo)向到這個(gè)域的 error 事件。
5domain.intercept(callback)
和 domain.bind(callback) 類似。除了捕捉被拋出的錯(cuò)誤外，它還會(huì)攔截 Error 對(duì)象作為參數(shù)傳遞到這個(gè)函數(shù)。
6domain.enter()
進(jìn)入一個(gè)異步調(diào)用的上下文，綁定到domain。
7domain.exit()
退出當(dāng)前的domain，切換到不同的鏈的異步調(diào)用的上下文中。對(duì)應(yīng)domain.enter()。
8domain.dispose()
釋放一個(gè)domain對(duì)象，讓node進(jìn)程回收這部分資源。
9domain.create()
返回一個(gè)domain對(duì)象。

屬性

序號(hào)屬性 & 描述
1domain.members
已加入domain對(duì)象的域定時(shí)器和事件發(fā)射器的數(shù)組。

實(shí)例

創(chuàng)建 main.js 文件，代碼如下所示：

var EventEmitter = require("events").EventEmitter;
var domain = require("domain");

var emitter1 = new EventEmitter();

// 創(chuàng)建域
var domain1 = domain.create();

domain1.on('error', function(err){
   console.log("domain1 處理這個(gè)錯(cuò)誤 ("+err.message+")");
});

// 顯式綁定
domain1.add(emitter1);

emitter1.on('error',function(err){
   console.log("監(jiān)聽器處理此錯(cuò)誤 ("+err.message+")");
});

emitter1.emit('error',new Error('通過(guò)監(jiān)聽器來(lái)處理'));

emitter1.removeAllListeners('error');

emitter1.emit('error',new Error('通過(guò) domain1 處理'));

var domain2 = domain.create();

domain2.on('error', function(err){
   console.log("domain2 處理這個(gè)錯(cuò)誤 ("+err.message+")");
});

// 隱式綁定
domain2.run(function(){
   var emitter2 = new EventEmitter();
   emitter2.emit('error',new Error('通過(guò) domain2 處理'));   
});


domain1.remove(emitter1);
emitter1.emit('error', new Error('轉(zhuǎn)換為異常，系統(tǒng)將崩潰!'));

執(zhí)行以上代碼，結(jié)果如下所示:

監(jiān)聽器處理此錯(cuò)誤 (通過(guò)監(jiān)聽器來(lái)處理)
domain1 處理這個(gè)錯(cuò)誤 (通過(guò) domain1 處理)
domain2 處理這個(gè)錯(cuò)誤 (通過(guò) domain2 處理)

events.js:72
        throw er; // Unhandled 'error' event
              ^
Error: 轉(zhuǎn)換為異常，系統(tǒng)將崩潰!
    at Object.<anonymous> (/www/node/main.js:40:24)
    at Module._compile (module.js:456:26)
    at Object.Module._extensions..js (module.js:474:10)
    at Module.load (module.js:356:32)
    at Function.Module._load (module.js:312:12)
    at Function.Module.runMain (module.js:497:10)
    at startup (node.js:119:16)
    at node.js:929:3

Node.js 工具模塊Node.js 工具模塊