BJ_web_developers / wikimanual

/**
 * amWiki Web端 - 浏览器数据缓存模块
 * @author Tevin
 */

;
(function (win) {

    'use strict';

    var tools = win.tools;
    var wikiPath = tools.simString(win.location.pathname.replace('/', '').replace(/\//g, '_')).toUpperCase();
    var LOCAL_STORAGE_NAME = 'AMWikiDataBase@' + wikiPath;  //本地数据localStorage键名
    var LOCAL_STATES = 'AMWikiStates@' + wikiPath;  //本地状态集键名

    /**
     * 本地存储管理
     * @constructor
     */
    var Storage = function () {
        this._db = null;  //内存中的文库缓存
        this._states = null;  //内存中的状态集
        this.$e = {
            win: $(win),
            //更新全部缓存按钮
            searchUpdate: $('#searchUpdate'),
            //缓存状态
            cacheState: $('#cacheState'),
            //文档总数
            cacheDocTotal: $('#cacheDocTotal'),
            //上次全部缓存更新时间
            cacheLasttime: $('#cacheLasttime')
        };
        this._bridgeLocalStorage('read');
        this._bindCtrl();
    };

    /**
     * 存取本地存储
     * @param {String} type - read / save
     * @private
     */
    Storage.prototype._bridgeLocalStorage = function (type) {
        if (type == 'read') {
            var defaultStr = '{"documents":{},"lastBuild":0}';
            this._db = JSON.parse(win.localStorage[LOCAL_STORAGE_NAME] || defaultStr);
            //转换旧名称
            if (typeof this._db.libraries != 'undefined') {
                this._db.documents = this._db.libraries;
                delete this._db.libraries;
            }
        } else if (type == 'save') {
            win.localStorage[LOCAL_STORAGE_NAME] = JSON.stringify(this._db);
        }
    };

    /**
     * 绑定操作
     * @private
     */
    Storage.prototype._bindCtrl = function () {
        var that = this;
        this.$e.win.on('beforeunload', function () {
            that._bridgeLocalStorage('save');
        });
    };

    /**
     * 更新一篇文档，如果相同则不操作(对应内容不用重新渲染)
     * @param {String} uri
     * @param {String} content
     * @returns {Boolean}
     * @public
     */
    Storage.prototype.update = function (uri, content) {
        var id = tools.simString(uri, 'short');
        if (this._db.documents[id]) {
            if (this._db.documents[id].content == content) {
                return false;
            } else {
                this.saveDoc(uri, content, id);
                return true;
            }
        } else {
            this.saveDoc(uri, content, id);
            return true;
        }
    };

    /**
     * 保存一篇文档
     * @param {String} uri - 文档资源地址
     * @param {String} content - 文档内容
     * @param {String} [id] - 已经编码的文档地址，可选
     * @public
     */
    Storage.prototype.saveDoc = function (uri, content, id) {
        this.saveDocToDB(uri, content, id);
        this._bridgeLocalStorage('save');
        this._changeSummary('sateOnly');
    };

    /**
     * 将文档存储到内存
     * @param {String} uri
     * @param {String} content
     * @param {String} id
     * @public
     */
    Storage.prototype.saveDocToDB = function (uri, content, id) {
        if (typeof uri != 'string' && uri == '') {
            throw new Error('Error, uri must be a string!');
        }
        if (typeof id == 'undefined') {
            id = tools.simString(uri, 'short');
        }
        this._db.documents[id] = {
            id: id,
            uri: uri,
            content: content || '',
            timestamp: Date.now()
        };
        this._changeSummary('sateOnly', 'prepare');
    };

    /**
     * 读取一篇文档
     * @param {String} uri - 文档资源地址
     * @returns {String} 文档内容
     * @public
     */
    Storage.prototype.read = function (uri) {
        var id = tools.simString(uri, 'short');
        var article = '';
        if (this._db.documents[id]) {
            article = this._db.documents[id].content;
        }
        return article;
    };

    /**
     * 读取一篇文档的时间
     * @param {String} uri - 文档资源地址
     * @returns {String} 文档内容
     * @public
     */
    Storage.prototype.readTime = function (uri) {
        var id = tools.simString(uri, 'short');
        if (this._db.documents[id]) {
            return this._db.documents[id].timestamp;
        } else {
            return 0;
        }
    };

    /**
     * 删除一篇文档
     * @param {String} uri - 文档资源地址
     * @public
     */
    Storage.prototype.remove = function (uri) {
        var id = tools.simString(uri, 'short');
        delete this._db.documents[id];
        this._bridgeLocalStorage('save');
        this._changeSummary('sateOnly');
    };

    /**
     * 增涨文档打开数记录
     * @param {String} uri
     * @public
     */
    Storage.prototype.increaseOpenedCount = function (uri) {
        var id = tools.simString(uri, 'short');
        //TODO: 待续...打开次数将一定程度影响排行
    };

    /**
     * 校对列表，清除失效文档
     * @param {Array} list - 由导航树偏平化生成的文档列表
     * @public
     */
    Storage.prototype.checkLibChange = function (list) {
        this._indexing = list;
        var documents = {};
        var id = '';
        for (var i = 0; i < list.length; i++) {
            id = tools.simString(list[i], 'short');
            if (typeof this._db.documents[id] != 'undefined') {
                documents[id] = this._db.documents[id];
            }
        }
        this._db.documents = documents;
        this._bridgeLocalStorage('save');
        this._changeSummary();
    };

    /**
     * 更新缓存摘要（位于搜素面板）
     * @param {String} stateOnly - 是否为只读 stateOnly / ...
     * @param {String} prepare - 是否为预先 prepare / ...
     * @private
     */
    Storage.prototype._changeSummary = function (stateOnly, prepare) {
        var libraryiesLong = 0;
        for (var p in this._db.documents) {
            if (this._db.documents.hasOwnProperty(p)) {
                libraryiesLong++;
            }
        }
        //如果是预先，百分数减1
        if (prepare == 'prepare') {
            this.$e.cacheState.text(parseInt(libraryiesLong / this._indexing.length * 100 - 1) + '%');
        }
        //非预先则正常
        else {
            this.$e.cacheState.text(parseInt(libraryiesLong / this._indexing.length * 100) + '%');
        }
        //如果不只是状态
        if (stateOnly != 'stateOnly') {
            this.$e.cacheDocTotal.text(this._indexing.length);
            if (this._db.lastBuild) {
                this.$e.cacheLasttime.text(win.tools.formatTime(this._db.lastBuild));
            } else {
                this.$e.cacheLasttime.text('0000-00-00 00:00:00');
            }
        }
    };

    /**
     * 清除内存中的库列表
     * @public
     */
    Storage.prototype.clearLibraries = function () {
        this._db.documents = {};
        this._changeSummary('sateOnly');
    };

    /**
     * 完成本次缓存重建
     * @public
     */
    Storage.prototype.saveRebuild = function () {
        this._db.lastBuild = Date.now();
        this._bridgeLocalStorage('save');
        this._changeSummary();
    };

    /**
     * 返回导航列表
     * @returns {Array}
     * @public
     */
    Storage.prototype.getIndexList = function () {
        return this._indexing;
    };

    /**
     * 获取当前缓存的所有文档
     * @returns {{Object}}
     * @public
     */
    Storage.prototype.getAllDocs = function () {
        return this._db.documents;
    };

    /**
     * 获取缓存最后重建时间
     * @returns {Number}
     * @public
     */
    Storage.prototype.getLastBuildTs = function () {
        return this._db.lastBuild;
    };

    /**
     * 获取本地存储中指定名称的值
     * @param {String} name
     * @returns {*}
     * @public
     */
    Storage.prototype.getStates = function (name) {
        if (!this._states) {
            this._states = JSON.parse(win.localStorage[LOCAL_STATES] || '{}');
        }
        return this._states[name];
    };

    /**
     * 保持键值对到本地存储
     * @param {String} name
     * @param {*} value
     * @public
     */
    Storage.prototype.setStates = function (name, value) {
        if (!this._states) {
            this._states = JSON.parse(win.localStorage[LOCAL_STATES] || '{}');
        }
        if (typeof value == 'undefined') {
            delete this._states[name];
        } else {
            this._states[name] = value;
        }
        win.localStorage[LOCAL_STATES] = JSON.stringify(this._states);
    };

    return win.AWStorage = Storage;

})(window);