nodejs学习之events

在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)得到的数组都将会无效.
emitter.setMaxListeners(n)
默认状况下,若是一个事件的监听函数超过10个,EventEmitters对象将会打印一个警告信息.这是一个发现内存溢出颇有用的方法.很明显不是全部的Emitters对象都应该限制10个监听器.这个函数将会容许增长限制个数,若是不想限制个数,能够设置为0.
emitter.listeners(event)
返回指定事件的监听函数数组.
server.on('connection', function (stream) {
console.log('someone connected!');
});
console.log(util.inspect(server.listeners('connection'))); // [ [Function] ]
在事件机制下,这个数组是易变的,会保持和事件的监听函数列表一直,然而,特定的动做(特别是removeAllListeners)将会是这个索引无效.
若是你须要在指定的时间得到一个不会改变的监听函数列表的copy,拿到一个副本,例如能够这么作:emitter.listeners(event).slice(0).
在node未来的release版本中,这个行为将会改变成老是返回一个不变的copy,在你的程序中,请不要依赖经过数组的函数来修改EventEmitters的监听函数.请老是使用'on'方法来添加一个新的监听.

emitter.emit(event,[arg1],[arg2],[...])
根据提供的参数列表来顺序执行每个监听函数.

Event:'newListener'
event String,the event name,事件字符串,事件的名字.
listener function the event handler function 监听函数,事件处理函数.
当任何一个对象(支持发出事件的)添加一个新监听函数时,将会发出这个事件.