node模块之events模块

events 模块只提供了一个对象: events.EventEmitter。

【EventEmitter 的核心就是事件触发与事件监听器功能的封装。】

EventEmitter 的每个事件由一个事件名和若干个参 数组成,事件名是一个字符串,通常表达一定的语义。对于每个事件,EventEmitter 支持 若干个事件监听器。当事件触发时,注册到这个事件的事件监听器被依次调用,事件参数作 为回调函数参数传递。

例子:

var events = require('events');

var emitter = new events.EventEmitter();

emitter.on('某个事件名', function(arg1, arg2) { console.log('监听器1', arg1, arg2) });

emitter.on('某个事件名', function(arg1, arg2) { console.log('监听器2', arg1, arg2) });

emitter.emit('某个事件名', 'hello', world);

运行的结果是:

监听器1 hello world
监听器2 hello world

在上面的例子中,emitter为某个事件注册了连个事件监听器,然后触发了某个事件。然后两个事件监听器被先后调用。

EventEmitter常用API:

EventEmitter.on(event, listener)  

//为指定事件注册一个监听器,接受一个字符串event 和一个回调函数listener。
EventEmitter.emit(event, [arg1], [arg2], [...]) 
// 触发 event 事件,传递若干可选参数到事件监听器的参数表。
EventEmitter.once(event, listener)
// 为指定事件注册一个单次监听器,即监听器最多只会触发一次,触发后立刻解除该监听器
EventEmitter.removeListener(event, listener)
// 移除指定事件的某个监听器,listener 必须是该事件已经注册过的监听器。
EventEmitter.removeAllListeners([event])
// 移除所有事件的所有监听器, 如果指定 event,则移除指定事件的所有监听器。

更多api可参考:http://nodejs.cn/api/events.html

【error事件】

EventEmitter 定义了一个特殊的事件 error,它包含了“错误”的语义,我们在遇到 异常的时候通常会发射 error 事件。当 error 被触发时,EventEmitter 规定如果没有响 应的监听器,Node.js 会把它当作异常,退出程序并打印调用栈。我们一般要为会发射 error 事件的对象设置监听器,避免遇到错误后整个程序崩溃。

例子:

var events = require('events');

var emitter = new events.EventEmitter();

emitter.emit('error');

运行时报错如下:

Error: Unhandled "error" event
at EventEmitter.emit (events.js:175:14)

【大多数情况下我们并不会直接去使用EventEmitter,而是在对象中继承它。】

包括 fs、net、 http 在内的,只要是支持事件响应的核心模块都是 EventEmitter 的子类。

上一篇:[转]1.2 java web的发展历史


下一篇:Erlang cowboy 入门参考