日期:2014-05-16  浏览次数:20295 次

一起读nodejs(七)----事件(Events)

    本文是对nodejs0.8.9版本的api开发手册解读.nodejs网址

    

    事件(Events) 

    stability:4 - API Frozen

    在node里许多对象都发出事件:一个net.Server对象每次一个连接到来,都发出一个事件,一个fs.readStream对象在文件打开时放出一个事件.所有能放出事件的对象都是event.EventEmitter对象的实例.你可以这样做来访问这个模块:requre('events');

    代表性的事件命名都是一个驼峰标识的字符串,然而这并不是一个强制约束,任何字符串都可以被接受.

    函数可以被附加在对象上,并且当一个事件发出时被执行.这样的函数叫做监听函数.


    Class:events.EventEmitter

    可以这样访问events.EventEmitter类,require('events').EventEmitter.

    当一个EventEmitter遇到一个错误时,典型的动作时发出一个error事件.在node里面,error事件将会被作为特殊情况处理,如果没有相应的监听函数,默认的动作是打印堆栈信息,然后退出程序.

    当所有的EventEmitter对象在添加新的监听函数时都会发出newListener事件.

    emitter.addListener(event,listener)

    emitter.on(event,listener)

    添加一个监听函数到指定的事件的监听函数数组的末尾.

server.on('connection', function (stream) {
  console.log('someone connected!');
});
    emitter.once(event,listener)

    为事件添加一个只执行一次的监听函数.这个监听函数只会在下次事件触发时执行一次,之后将会被移除.

server.once('connection', function (stream) {
  console.log('Ah, we have our first user!');
});

    emitter.removeListener(event,listener)

    在指定事件的监听函数数组中移除一个监听函数.注意:移除之后,将会改变在被移除监听函数之后的其他监听函数的数组索引.

var callback = function(stream) {
  console.log('someone connected!');
};
server.on('connection', callback);
// ...
server.removeListener('connection', callback);

    emitter.removeAllListeners([event])

    不带参数的话,会移除所有的监听函数,但参数的话只移除指定事件的所有监听函数.

    注意:在之前使用emitter.listeners(event)获得的数组都将会无效.

    emitt