Theia APIs——事件

上一篇：Theia APIs——Preferences

事件

　　Theia中的事件或許會讓你感到困惑，但願本節能闡述清楚。

　　來看下面的代碼：

（來自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是事件處理程序的容器，能夠在上面註冊事件處理程序並使用類型爲X的事件觸發它，在上面的例子中，X的類型爲ILogLevelChangedEvent。

　　因此這裏咱們建立了一個 Emitter，它將包含全部類型爲ILogLevelChangedEvent的事件。

　　接下來，咱們但願可以在這個 Emitter上註冊一個事件處理程序，能夠像這樣：

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

　　它實際返回的是一個函數，用來註冊事件處理程序，你只須要將事件處理程序的函數傳遞給它，它將註冊該事件，而後當事件觸發的時候該處理程序會被調用。

　　你能夠這樣調用：

（來自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上註冊一個匿名函數，並將其做爲參數進行傳遞。

　　接下來，咱們須要觸發一個事件來執行該事件處理程序。

onLogLevelChanged(event: ILogLevelChangedEvent) {
                emitter.fire(event)
            }

　　當調用該函數時，emitter觸發並調用全部的事件處理程序。

　　因此，若是你想在Theia中觸發事件，須要：

• 建立一個emitter
• 使用emitter.event函數註冊事件
• 使用emitter.fire(event)函數觸發事件

 

原文地址：https://theia-ide.org/docs/events