309 lines
8.6 KiB
JavaScript
309 lines
8.6 KiB
JavaScript
/**
|
||
* 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); |