27. 域模块

• Internal Binding – 错误发射器正在域的run方法中执行其代码。
• External Binding – 使用其add方法将错误发射器显式添加到域。

var domain = require("domain");
var child = domain.create();

• domain.run(function)：在域的上下文中运行提供的函数，隐式绑定在该上下文中创建的所有事件发射器，计时器和低级请求。 这是使用域的最基本方式。
• domain.add(emitter)：明确地向域添加发射器。 如果发射器调用的任何事件处理程序抛出错误，或者发射器发出错误事件，它将被路由到域的错误事件，就像使用隐式绑定一样。
• domain.remove(emitter)：与domain.add（发射器）相反。从指定的发射器中删除域处理。
• domain.bind(callback)：返回的函数将是提供的回调函数的包装器。调用返回的函数时，抛出的任何错误都将路由到域的错误事件。
• domain.intercept(callback)：此方法几乎与domain.bind（回调）相同。但是，除了捕获抛出的错误之外，它还将拦截作为函数的第一个参数发送的Error对象。
• domain.enter()：enter方法是run，bind和intercept方法用于设置活动域的管道。 它将domain.active和process.domain设置为域，并隐式地将域推送到域模块管理的域堆栈（有关域堆栈的详细信息，请参阅 domain.exit()）。 对enter的调用分隔了一系列异步调用的开始和绑定到域的I/O操作。
• domain.exit()：exit方法退出当前域，将其从域堆栈中弹出。每当执行切换到不同的异步调用链的上下文时，确保退出当前域很重要。对exit的调用分隔了异步调用链的结束或中断以及绑定到域的I/O操作。
• domain.dispose()：一旦调用dispose，域将不再被通过run，bind或intercept绑定到域中的回调使用，并且dispose事件将被释放。

• domain.members：已明确添加到域中的计时器和事件发射器数组。

var EventEmitter = require("events").EventEmitter;
var domain = require("domain");
var emitter1 = new EventEmitter();
// Create a domain
var domain1 = domain.create();
domain1.on('error', function(err) {
   console.log("domain1 handled this error ("+err.message+")");
});
// Explicit binding 
domain1.add(emitter1);
emitter1.on('error',function(err) {
   console.log("listener handled this error ("+err.message+")");
});
emitter1.emit('error',new Error('To be handled by listener'));
emitter1.removeAllListeners('error');
emitter1.emit('error',new Error('To be handled by domain1'));
var domain2 = domain.create();
domain2.on('error', function(err) {
   console.log("domain2 handled this error ("+err.message+")");
});
// Implicit binding
domain2.run(function() {
   var emitter2 = new EventEmitter();
   emitter2.emit('error',new Error('To be handled by domain2'));   
});
domain1.remove(emitter1);
emitter1.emit('error', new Error('Converted to exception. System will crash!'));

listener handled this error (To be handled by listener)
domain1 handled this error (To be handled by domain1)
domain2 handled this error (To be handled by domain2)
events.js:72 throw er; // Unhandled 'error' event
         ^
Error: Converted to exception. System will crash!
   at Object. (/web/com/1427722220_30772/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:906:3