nodeJS入门例子一—事件（Event）

go4321

Events

events.EventEmitter

emitter.addListener(event, listener)

emitter.on(event, listener)

emitter.once(event, listener)

emitter.removeListener(event, listener)

emitter.removeAllListeners([event])

emitter.setMaxListeners(n)

emitter.listeners(event)

emitter.emit(event, [arg1], [arg2], [...])
　　Event: 'newListener'
　　


Events
　　许多对象在Node中可以派发事件：一个net.Server每次一个链接链接到它时派发一个事件，当一个文件被打开时fs.readStream派发一个事件。所有派发事件的对象都是events.EventEmitter 的实体。可以通过 require('events') 访问此模块。
　　一般事件名称是用一个大小写混合（camel-cased ）的字符串表示，然而，没有严格的限制，因为任何字符串将被接受。

函数可以归宿某个对象，当事件派发时可以被执行。这些函数叫做监听器。

events.EventEmitter
　　可以通过require('events').EventEmitter访问EeventEmitter类。
　　当一个EventEmitter表达错误时，一般会派发一个'error'事件， Error事件在node中作为一个特例。如果没有对此做监听，默认行为就是打印错误日志并退出当前程序。
　　当一个新的监听添加时，所有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.setMaxListeners(n)
　　默认情况下当一个事件的监听超过10个时，EventEmitter 将打印警告信息。这对于内存泄漏的查找很有帮助。当然业非所有的Emitters都应该限制在10个。这些函数允许增长，设置0表示无限制。

　　


emitter.listeners(event)
　　返回特定事件的事件监听器集合。这个集合可以人工干预，如删除一个事件监听器。

　　


server.on('connection', function (stream) {
console.log('someone connected!');
});
console.log(util.inspect(server.listeners('connection'))); // [ [Function] ]
emitter.emit(event, [arg1], [arg2], [...])
　　用提供的参数按顺序执行每个事件监听器。


Event: 'newListener'
　　function (event, listener) { }
　　当添加新的监听时，这个事件每次都会被派发