Node.js Domain 模块 - Node.js 基础教程 - 简单教程，简单编程

Node.js Domain(域) 简化异步代码的异常处理，可以捕捉处理 try catch 无法捕捉的异常

引入 Domain 模块

var domain = require("domain")

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

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

隐式绑定: 把在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对象

Domain 模块属性

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

范例

main.js

/*
 * filename: main.js
 * author: 简单教程(www.twle.cn)
 * Copyright © 2015-2065 www.twle.cn. All rights reserved.
*/

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('转换为异常，系统将崩溃!'));

运行以上 Node.js 脚本，输出结果如下

$ node main.js 
监听器处理此错误 (通过监听器来处理)
domain1 处理这个错误 (通过 domain1 处理)
domain2 处理这个错误 (通过 domain2 处理)
events.js:182
      throw er; // Unhandled 'error' event
      ^

Error: 转换为异常，系统将崩溃!
    at Object.<anonymous> (/Users/luojianguo/Downloads/curl_mail/node/main.js:46:24)
    at Module._compile (module.js:624:30)
    at Object.Module._extensions..js (module.js:635:10)
    at Module.load (module.js:545:32)
    at tryModuleLoad (module.js:508:12)
    at Function.Module._load (module.js:500:3)
    at Function.Module.runMain (module.js:665:10)
    at startup (bootstrap_node.js:187:16)
    at bootstrap_node.js:608:3