7、Node.js EventEmitter
?
#######################################################################################介紹
Node.js EventEmitter
Node.js 所有的異步 I/O 操作在完成時都會發(fā)送一個事件到事件隊列。
Node.js里面的許多對象都會分發(fā)事件:一個net.Server對象會在每次有新連接時分發(fā)一個事件, 一個fs.readStream對象會在文件被打開的時候發(fā)出一個事件。 所有這些產(chǎn)生事件的對象都是 events.EventEmitter 的實(shí)例。
#################################################################################創(chuàng)建步驟
EventEmitter 類
events 模塊只提供了一個對象: events.EventEmitter。EventEmitter 的核心就是事件觸發(fā)與事件監(jiān)聽器功能的封裝。
可以通過require("events");來訪問該模塊。
EventEmitter 對象如果在實(shí)例化時發(fā)生錯誤,會觸發(fā) error 事件。當(dāng)添加新的監(jiān)聽器時,newListener 事件會觸發(fā),當(dāng)監(jiān)聽器被移除時,removeListener 事件被觸發(fā)。
#######例子
下面我們用一個簡單的例子說明 EventEmitter 的用法:
//event.js 文件
執(zhí)行結(jié)果如下:
運(yùn)行這段代碼,1 秒后控制臺輸出了 'some_event 事件觸發(fā)'。其原理是 event 對象注冊了事件 some_event 的一個監(jiān)聽器,然后我們通過 setTimeout 在 1000 毫秒以后向 event 對象發(fā)送事件 some_event,此時會調(diào)用some_event 的監(jiān)聽器。
EventEmitter 的每個事件由一個事件名和若干個參數(shù)組成,對于每個事件,EventEmitter支持若干個事件監(jiān)聽器。
當(dāng)事件觸發(fā)時,注冊到這個事件的事件監(jiān)聽器被依次調(diào)用,事件參數(shù)作為回調(diào)函數(shù)參數(shù)傳遞。
#########讓我們以下面的例子解釋這個過程:
//event.js 文件
?
以上例子中,emitter 為事件 someEvent 注冊了兩個事件監(jiān)聽器,然后觸發(fā)了 someEvent 事件。
運(yùn)行結(jié)果中可以看到兩個事件監(jiān)聽器回調(diào)函數(shù)被先后調(diào)用。 這就是EventEmitter最簡單的用法。
EventEmitter 提供了多個屬性,如 on 和 emit。on 函數(shù)用于綁定事件函數(shù),emit 屬性用于觸發(fā)一個事件。接下來我們來具體看下 EventEmitter 的屬性介紹。
###########################################################################################
EventEmitter方法
1
addListener(event, listener)
為指定事件添加一個監(jiān)聽器到監(jiān)聽器數(shù)組的尾部。
2
on(event, listener)
為指定事件注冊一個監(jiān)聽器,接受一個字符串 event 和一個回調(diào)函數(shù)。
server.on('connection', function (stream) {
? console.log('someone connected!');
});
3
once(event, listener)
為指定事件注冊一個單次監(jiān)聽器,即 監(jiān)聽器最多只會觸發(fā)一次,觸發(fā)后立刻解除該監(jiān)聽器。
server.once('connection', function (stream) {
? console.log('Ah, we have our first user!');
});
4
removeListener(event, listener)
移除指定事件的某個監(jiān)聽器,監(jiān)聽器必須是該事件已經(jīng)注冊過的監(jiān)聽器。
它接受兩個參數(shù),第一個是事件名稱,第二個是回調(diào)函數(shù)名稱。
var callback = function(stream) {
? console.log('someone connected!');
};
server.on('connection', callback);
// ...
server.removeListener('connection', callback);
5
removeAllListeners([event])
移除所有事件的所有監(jiān)聽器, 如果指定事件,則移除指定事件的所有監(jiān)聽器。
6
setMaxListeners(n)
默認(rèn)情況下, EventEmitters 如果你添加的監(jiān)聽器超過 10 個就會輸出警告信息。 setMaxListeners 函數(shù)用于提高監(jiān)聽器的默認(rèn)限制的數(shù)量。
7
listeners(event)
返回指定事件的監(jiān)聽器數(shù)組。
8
emit(event, [arg1], [arg2], [...])
按參數(shù)的順序執(zhí)行每個監(jiān)聽器,如果事件有注冊監(jiān)聽返回 true,否則返回 false。
##########################################################################################
EventEmitter類方法
listenerCount(emitter, event)
返回指定事件的監(jiān)聽器數(shù)量。
###################################################################################
EventEmitter事件
1
newListener
?? ?? event - 字符串,事件名稱
?? ?? listener - 處理事件函數(shù)
該事件在添加新監(jiān)聽器時被觸發(fā)。
2
removeListener
?? ?? event - 字符串,事件名稱
?? ?? listener - 處理事件函數(shù)
從指定監(jiān)聽器數(shù)組中刪除一個監(jiān)聽器。需要注意的是,此操作將會改變處于被刪監(jiān)聽器之后的那些監(jiān)聽器的索引。
######################################################################################
實(shí)例
以下實(shí)例通過 connection(連接)事件演示了 EventEmitter 類的應(yīng)用。
?
##########################################################################################
error 事件
EventEmitter 定義了一個特殊的事件 error,它包含了錯誤的語義,我們在遇到 異常的時候通常會觸發(fā) error 事件。
當(dāng) error 被觸發(fā)時,EventEmitter 規(guī)定如果沒有響 應(yīng)的監(jiān)聽器,Node.js 會把它當(dāng)作異常,退出程序并輸出錯誤信息。
我們一般要為會觸發(fā) error 事件的對象設(shè)置監(jiān)聽器,避免遇到錯誤后整個程序崩潰。例如:
如下:
events.js:188
????? throw err;
????? ^
Error: Unhandled "error" event. (undefined)
??? at EventEmitter.emit (events.js:186:19)
??? at Object.<anonymous> (F:\nodejs_code\4_EventEmitter\error_example.js:9:9)
??? at Module._compile (module.js:652:30)
??? at Object.Module._extensions..js (module.js:663:10)
??? at Module.load (module.js:565:32)
??? at tryModuleLoad (module.js:505:12)
??? at Function.Module._load (module.js:497:3)
??? at Function.Module.runMain (module.js:693:10)
??? at startup (bootstrap_node.js:191:16)
??? at bootstrap_node.js:612:3
*/
?
?
#######################################################################################
繼承 EventEmitter
大多數(shù)時候我們不會直接使用 EventEmitter,而是在對象中繼承它。包括 fs、net、 http 在內(nèi)的,只要是支持事件響應(yīng)的核心模塊都是 EventEmitter 的子類。
這樣做的原因有兩點(diǎn):
首先,具有某個實(shí)體功能的對象實(shí)現(xiàn)事件符合語義, 事件的監(jiān)聽和發(fā)生應(yīng)該是一個對象的方法。
其次 JavaScript 的對象機(jī)制是基于原型的,支持部分多重繼承,繼承 EventEmitter 不會打亂對象原有的繼承關(guān)系。
?
轉(zhuǎn)載于:https://www.cnblogs.com/-nbloser/p/9125549.html
總結(jié)
以上是生活随笔為你收集整理的7、Node.js EventEmitter的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: python.day01笔记
- 下一篇: ansible部署