Node.js Domain 模塊
Node.jsDomain(域)簡化異步代碼的異常處理,可以捕捉處理try catch無法捕捉的異常。引入Domain 模塊語法格式如下:
var domain = require("domain")
domain模塊,把處理多個不同的IO的操作作為一個組。 註冊事件和回調到domain,當發生一個錯誤事件或拋出一個錯誤時,domain對象會被通知,不會丟失上下文環境,也不導致程序錯誤立即推出,與process.on('uncaughtException')不同。
Domain 模塊可分為隱式綁定和顯式綁定:
- 隱式綁定: 把在domain上下文中定義的變量,自動綁定到domain對象
- 顯式綁定: 把不是在domain上下文中定義的變量,以代碼的方式綁定到domain對象
方法
序號 | 方法& 描述 |
---|---|
1 | domain.run(function) 在域的上下文運行提供的函數,隱式的綁定了所有的事件分發器,計時器和底層請求。 |
2 | domain.add(emitter) 顯式的增加事件 |
3 | domain.remove(emitter) 刪除事件。 |
4 | domain.bind(callback) 返回的函數是一個對於所提供的回調函數的包裝函數。 當調用這個返回的函數被時,所有被拋出的錯誤都會被導向到這個域的error 事件。 |
5 | domain.intercept(callback) 和domain.bind(callback) 類似。 除了捕捉被拋出的錯誤外,它還會攔截Error 對像作為參數傳遞到這個函數。 |
6 | domain.enter() 進入一個異步調用的上下文,綁定到domain。 |
7 | domain.exit() 退出當前的domain,切換到不同的鏈的異步調用的上下文中。 對應domain.enter()。 |
8 | domain.dispose() 釋放一個domain對象,讓node進程回收這部分資源。 |
9 | domain.create() 返回一個domain對象。 |
屬性
序號 | 屬性& 描述 |
---|---|
1 | domain.members 已加入domain對象的域定時器和事件發射器的數組。 |
實例
創建main.js 文件,代碼如下所示:
var EventEmitter = require("events").EventEmitter; var domain = require("domain"); var emitter1 = new EventEmitter(); // 创建域 var domain1 = domain.create(); domain1.on('error', function(err){ console.log("domain1 处理这个错误 ("+err.message+")"); }); // 显式绑定 domain1.add(emitter1); emitter1.on('error',function(err){ console.log("监听器处理此错误 ("+err.message+")"); }); emitter1.emit('error',new Error('通过监听器来处理')); emitter1.removeAllListeners('error'); emitter1.emit('error',new Error('通过 domain1 处理')); var domain2 = domain.create(); domain2.on('error', function(err){ console.log("domain2 处理这个错误 ("+err.message+")"); }); // 隐式绑定 domain2.run(function(){ var emitter2 = new EventEmitter(); emitter2.emit('error',new Error('通过 domain2 处理')); }); domain1.remove(emitter1); emitter1.emit('error', new Error('转换为异常,系统将崩溃!'));
執行以上代碼,結果如下所示:
监听器处理此错误 (通过监听器来处理) domain1 处理这个错误 (通过 domain1 处理) domain2 处理这个错误 (通过 domain2 处理) events.js:72 throw er; // Unhandled 'error' event ^ Error: 转换为异常,系统将崩溃! 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