Theia APIs——事件

事件
　　Theia中的事件或許會(huì)讓你感到困惑，希望本節(jié)能闡述清楚。
　　來看下面的代碼：
（來自logger-watcher.ts）

@injectable()
export class LoggerWatcher {

getLoggerClient(): ILoggerClient {
    const emitter = this.onLogLevelChangedEmitter
    return {
        onLogLevelChanged(event: ILogLevelChangedEvent) {
            emitter.fire(event)
        }
    }
}

private onLogLevelChangedEmitter = new Emitter<ILogLevelChangedEvent>();

get onLogLevelChanged(): Event<ILogLevelChangedEvent> {
    return this.onLogLevelChangedEmitter.event;
}

}

　　先來看看這一行：

private onLogLevelChangedEmitter = new Emitter<ILogLevelChangedEvent>();
　　首先，什么是Emitter？
　　Emitter是事件處理程序的容器，可以在上面注冊(cè)事件處理程序并使用類型為X的事件觸發(fā)它，在上面的例子中，X的類型為ILogLevelChangedEvent。
　　所以這里我們創(chuàng)建了一個(gè)Emitter，它將包含所有類型為ILogLevelChangedEvent的事件。
　　接下來，我們希望能夠在這個(gè)Emitter上注冊(cè)一個(gè)事件處理程序，可以像這樣：
get onLogLevelChanged(): Event<ILogLevelChangedEvent> {
return this.onLogLevelChangedEmitter.event;
}
　　它實(shí)際返回的是一個(gè)函數(shù)，用來注冊(cè)事件處理程序，你只需要將事件處理程序的函數(shù)傳遞給它，它將注冊(cè)該事件，然后當(dāng)事件觸發(fā)的時(shí)候該處理程序會(huì)被調(diào)用。
　　你可以這樣調(diào)用：
（來自logger.ts）

/ Update the root logger log level if it changes in the backend. /
loggerWatcher.onLogLevelChanged(event => {
this.id.then(id => {
if (id === this.rootLoggerId) {
this._logLevel = Promise.resolve(event.newLogLevel);
}
});
});

　　這將在emitter上注冊(cè)一個(gè)匿名函數(shù)，并將其作為參數(shù)進(jìn)行傳遞。
　　接下來，我們需要觸發(fā)一個(gè)事件來執(zhí)行該事件處理程序。
onLogLevelChanged(event: ILogLevelChangedEvent) {
emitter.fire(event)
}
　　當(dāng)調(diào)用該函數(shù)時(shí)，emitter觸發(fā)并調(diào)用所有的事件處理程序。
　　所以，如果你想在Theia中觸發(fā)事件，需要：
創(chuàng)建一個(gè)emitter
使用emitter.event函數(shù)注冊(cè)事件
使用emitter.fire(event)函數(shù)觸發(fā)事件