jsdk-offical/source/app/App.ts

JSDK is the most comprehensive TypeScript framework, like JDK.

/**
 * @project JSDK 
 * @license MIT
 * @website https://github.com/fengboyue/jsdk
 * 
 * @version 2.0.0
 * @author Frank.Feng
 */
/// <reference path="../lang/System.ts"/>
/// <reference path="../view/View.ts"/>
/// <reference path="Page.ts"/>

module JS {

    export namespace app {

        /**
         * Application-level Event which will be broadcasted to all opening pages of the app.
         * 应用级事件，广播到该应用的所有打开页面
         */
        export class AppEvent extends CustomEvent<any> {
            public fromUrl: string;
            public fromPage: string;

            constructor(type: string, initDict?: any) {
                super(type, initDict)
            }
        }

        /**
         * Application's config
         * 应用的设置
         */
        export type AppConfig = {
            /**
             * Application's name
             * 应用名称
             */
            name: string,
            /**
             * Application's version: {x}.{y}.{z}
             * 版本号: {x}.{y}.{z}
             */
            version?: string,
            /**
             * Log level
             * 日志级别
             */
            logLevel?: LogLevel,
            /**
             * Custom global options
             * 自定义全局配置
             */
            properties?: JsonObject
        }

        /**
         * Application Class
         * 应用主类
         */
        export class App {

            private static _cfg: AppConfig;
            private static _logger: Log;

            /**
             * Application needs to be initialized first. 
             * 应用需要先初始化
             * @param cfg 
             */
            public static init(cfg: AppConfig) {
                this._cfg = cfg;
                this._cfg.properties = this._cfg.properties || {};
                this._logger = new Log(this.NS(), cfg.logLevel || LogLevel.INFO);
            }

            /**
             * Application's namespace: {appName}/{version}
             * 应用的名称空间：{应用名}/{版本号}
             */
            public static NS() {
                return this._cfg.name + '/' + this.version()
            }
            /**
             * Application's name
             * 应用名称
             */
            public static appName() {
                return this._cfg.name
            }
            /**
             * Application's version: {x}.{y}.{z}
             * 版本号: {x}.{y}.{z}
             */
            public static version() {
                return this._cfg.version
            }
            /**
             * Returns the logger of application.
             * 返回应用的日志类
             */
            public static logger() {
                return this._logger
            }
            /**
             * Read the global options.
             * 读取所有自定义配置
             */
            public static properties(): JsonObject
            /**
             * Write the global options.
             * 覆写所有自定义配置
             */
            public static properties(properties: JsonObject): App
            public static properties(properties?: JsonObject): any {
                if (arguments.length == 0) return this._cfg.properties;
                this._cfg.properties = Jsons.union(this._cfg.properties, properties);
                return this
            }

            /**
             * Read the key option.
             * 读取配置项
             */
            public static property(key: string): any
            /**
             * Write the key option.
             * 覆写配置项
             */
            public static property(key: string, val: any): App
            public static property(key: string, val?: any): any {
                if (arguments.length == 1) return this.properties()[key];
                return this.properties({ key: val });
            }

            public static _bus = new EventBus(App);

            /**
             * Fires an applition-level event.
             * 触发一个应用事件
             * @param e 
             * @param arg 
             */
            public static fireEvent<E>(e: E, arg?: StoreDataType) {
                let p = Page.currentPage(), pn = p && (<Object>p).className,
                    k = `${e}|${pn ? `${pn}|` : ''}${App.NS()}`;
                LocalStore.remove(k);
                LocalStore.set(k, arg);
            }
            /**
             * Listen an applition-level event.
             * 监听一个应用事件
             */
            public static onEvent<H = EventHandler<App>>(e: string, handler: H, once?: boolean) {
                this._bus.on(<any>e, handler, once)
            }
            /**
             * Cancels all listeners of an applition-level event.
             * 取消一个应用事件的所有监听
             */
            public static offEvent(e: string) {
                this._bus.off(e)
            }
        }

    }
}
import App = JS.app.App;
import AppEvent = JS.app.AppEvent;
import AppConfig = JS.app.AppConfig;

//////////////////////////////////////////////////
(function () {
    var oldSetItem = localStorage.setItem;
    localStorage.setItem = function (key, val) {
        let ev = new CustomEvent('AppEvent');
        ev['key'] = key;
        ev['newValue'] = val;
        window.dispatchEvent(ev);
        oldSetItem.apply(this, arguments);
    }
    window.on('AppEvent storage', (e: StorageEvent) => {//第一个事件名是为了自页面也同时监听
        if (e.newValue == null) return;//如果是storage事件在删除数据项则忽略

        let name = e.key;
        if (!name || name.indexOf('|' + App.NS()) < 0) return; //非本应用的APP事件则忽略
        
        let ps = name.split('|'),
            ev = new AppEvent(ps[0]);//取事件名
        ev.fromUrl = e.url;
        ev.fromPage = ps.length==3?ps[1]:null;
        App._bus.fire(ev, [StoreHelper.parse(e.newValue)]);
    });
})()