Node.js Domain 模块

Node.js Domain(域) 简化异步代码的异常处理，可以捕捉处理try catch无法捕捉的异常。引入 Domain 模块 语法格式如下：

  1. var domain = require("domain")

domain模块，把处理多个不同的IO的操作作为一个组。注册事件和回调到domain，当发生一个错误事件或抛出一个错误时，domain对象会被通知，不会丢失上下文环境，也不导致程序错误立即推出，与process.on('uncaughtException')不同。

Domain 模块可分为隐式绑定和显式绑定：

  • 隐式绑定: 把在domain上下文中定义的变量，自动绑定到domain对象
  • 显式绑定: 把不是在domain上下文中定义的变量，以代码的方式绑定到domain对象

方法

序号方法 & 描述
1domain.run(function) 在域的上下文运行提供的函数，隐式的绑定了所有的事件分发器，计时器和底层请求。
2domain.add(emitter) 显式的增加事件
3domain.remove(emitter) 删除事件。
4domain.bind(callback) 返回的函数是一个对于所提供的回调函数的包装函数。当调用这个返回的函数被时，所有被抛出的错误都会被导向到这个域的 error 事件。
5domain.intercept(callback) 和 domain.bind(callback) 类似。除了捕捉被抛出的错误外，它还会拦截 Error 对象作为参数传递到这个函数。
6domain.enter() 进入一个异步调用的上下文，绑定到domain。
7domain.exit() 退出当前的domain，切换到不同的链的异步调用的上下文中。对应domain.enter()。
8domain.dispose() 释放一个domain对象，让node进程回收这部分资源。
9domain.create() 返回一个domain对象。

属性

序号属性 & 描述
1domain.members 已加入domain对象的域定时器和事件发射器的数组。

实例

创建 main.js 文件，代码如下所示：

  1. var EventEmitter = require("events").EventEmitter;
  2. var domain = require("domain");
  3.  
  4. var emitter1 = new EventEmitter();
  5.  
  6. // 创建域
  7. var domain1 = domain.create();
  8.  
  9. domain1.on('error', function(err){
  10.    console.log("domain1 处理这个错误 ("+err.message+")");
  11. });
  12.  
  13. // 显式绑定
  14. domain1.add(emitter1);
  15.  
  16. emitter1.on('error',function(err){
  17.    console.log("监听器处理此错误 ("+err.message+")");
  18. });
  19.  
  20. emitter1.emit('error',new Error('通过监听器来处理'));
  21.  
  22. emitter1.removeAllListeners('error');
  23.  
  24. emitter1.emit('error',new Error('通过 domain1 处理'));
  25.  
  26. var domain2 = domain.create();
  27.  
  28. domain2.on('error', function(err){
  29.    console.log("domain2 处理这个错误 ("+err.message+")");
  30. });
  31.  
  32. // 隐式绑定
  33. domain2.run(function(){
  34.    var emitter2 = new EventEmitter();
  35.    emitter2.emit('error',new Error('通过 domain2 处理'));   
  36. });
  37.  
  38.  
  39. domain1.remove(emitter1);
  40. emitter1.emit('error', new Error('转换为异常，系统将崩溃!'));

执行以上代码，结果如下所示:

  1. 监听器处理此错误 (通过监听器来处理)
  2. domain1 处理这个错误 (通过 domain1 处理)
  3. domain2 处理这个错误 (通过 domain2 处理)
  4.  
  5. events.js:72
  6.         throw er; // Unhandled 'error' event
  7.               ^
  8. Error: 转换为异常，系统将崩溃!
  9.     at Object.<anonymous> (/www/node/main.js:40:24)
  10.     at Module._compile (module.js:456:26)
  11.     at Object.Module._extensions..js (module.js:474:10)
  12.     at Module.load (module.js:356:32)
  13.     at Function.Module._load (module.js:312:12)
  14.     at Function.Module.runMain (module.js:497:10)
  15.     at startup (node.js:119:16)
  16.     at node.js:929:3