mm_os 1.3.4 → 1.3.5

package/core/com/nav/viewmodel.js

@@ -0,0 +1,296 @@
+/**
+ * 视图模型
+ * @class
+ */
+class ViewModel {
+	/**
+	 * 配置参数
+	 * @param {Object} config
+	 */
+	constructor(config) {
+
+	}
+}
+
+/**
+ * 获取显示类型 
+ * @param {String} key
+ * @param {Boolean} f 是否带格式
+ * @return {String} 返回显示类型
+ */
+ViewModel.prototype.get_type = function(key, f) {
+	var show = '';
+	switch (key) {
+		case "search":
+			show = f ? "select" : "";
+			break;
+		case "view":
+			show = "text";
+			break;
+		case "table":
+			show = f ? "select" : "text";
+			break;
+		case "edit":
+			show = f ? "select" : "input";
+			break;
+		case "list":
+			show = "text";
+			break;
+		case "details":
+			show = "text";
+			break;
+		case "batch":
+			show = f ? "select" : "";
+			break;
+		case "filter":
+			show = f ? "select" : "";
+			break;
+		default:
+			show = f ? "select" : "";
+			break;
+	}
+	return show;
+};
+
+/**
+ * 查询显示方式
+ * @param {Array} arr
+ * @param {String} key
+ * @param {Boolean} f 是否带格式
+ * @return {String}
+ */
+ViewModel.prototype.get_show = function(arr, key, f) {
+	var bl = false;
+	var show = '';
+	for (var i = 0; i < arr.length; i++) {
+		var str = arr[i];
+		if (str.indexOf(key + "_no") !== -1) {
+			bl = true;
+			break;
+		} else if (str.indexOf(key + "_input") !== -1) {
+			show = 'input';
+			break;
+		} else if (str.indexOf(key + "_select") !== -1) {
+			show = 'select';
+			break;
+		} else if (str.indexOf(key + "_text") !== -1) {
+			show = 'text';
+			break;
+		}
+	}
+	if (!show && !bl) {
+		show = this.get_type(key, f);
+	}
+	return show;
+};
+
+/**
+ * 获取表格所需键值对
+ * @param {Object} model 模型
+ * @return {Object} 返回视图所用模型
+ */
+ViewModel.prototype.field = async function(model) {
+	var list = model.param.list;
+	if (!list) {
+		model.param.list = [];
+		return [];
+	}
+	var field;
+	if (model.file.indexOf('_form') !== -1 || model.file.indexOf('_view') !== -1) {
+		field = model.sql.field_obj || '';
+	} else {
+		field = model.sql.field_default || '';
+	}
+	var requireds = [];
+	var add = model.param.add;
+	if (add) {
+		requireds = add.body_required;
+	}
+	var arr = field.replace(/`/g, '').split(',');
+	var pm = [];
+	for (var i = 0; i < list.length; i++) {
+		var o = list[i];
+		var name = o.name;
+		if (arr.indexOf(name) !== -1) {
+			var obj = Object.assign({}, o);
+			var format = model.sql.format.getObj({
+				key: name
+			});
+			var f = false;
+			if (format) {
+				obj.title = format.title;
+				obj.format = format;
+				f = true;
+			}
+			if (requireds.indexOf(name) !== -1) {
+				obj.required = true;
+			}
+			var desc = obj.description;
+			var show = {};
+			
+			if (desc.indexOf("##") === -1) {
+				show.form = f ? "select" : "input";
+				show.view = "text";
+				show.search = f ? "select" : "";
+				show.table = f ? "select" : "text";
+				show.list = "text";
+				show.edit = f ? "select" : "input";
+				show.details = "text";
+				show.batch = f ? "select" : "";
+				show.filter = f ? "select" : "";
+			} else {
+				desc = desc.between("##", "##");
+				obj.description = obj.description.replace("##" + desc + "##", "");
+				var ar = desc.trim().split(" ");
+				if (desc.indexOf("none") !== -1) {
+					show.form = '';
+					show.view = '';
+					show.search = '';
+					show.table = '';
+					show.list = '';
+					show.edit = '';
+					show.details = '';
+					show.batch = '';
+					show.filter = '';
+				} else {
+					// 后端 - 搜索栏
+					show.search = this.get_show(ar, "search", f);
+					// 后端 - 表格
+					show.table = this.get_show(ar, "table", f);
+					// 后端 - 表单页
+					show.form = this.get_show(ar, "form", f);
+					// 后端 - 详情页
+					show.view = this.get_show(ar, "view", f);
+					// 后端 - 批量操作
+					show.batch = this.get_show(ar, "batch", f);
+
+					// 前端 - 列表
+					show.list = this.get_show(ar, "list", f);
+					// 前端 - 详情页
+					show.details = this.get_show(ar, "details", f);
+					// 前端 - 筛选栏
+					show.filter = this.get_show(ar, "filter", f);
+					// 前端 - 编辑页
+					show.edit = this.get_show(ar, "edit", f);
+				}
+			}
+			obj.show = show;
+			pm.push(obj);
+		}
+	}
+	return pm;
+};
+
+/**
+ * 运算视图模型（css）
+ * @param {Object} model 模型
+ * @return {Object} 返回视图所用模型
+ */
+ViewModel.prototype.css = async function(model) {
+	var css = {};
+	return css;
+};
+
+/**
+ * 运算视图模型（html）
+ * @param {Object} model 模型
+ * @return {Object} 返回视图所用模型
+ */
+ViewModel.prototype.html = async function(model) {
+	var html = {};
+	if (!model.sql) {
+		return html;
+	}
+	return html;
+};
+
+/**
+ * 运算视图模型（js）
+ * @param {Object} model 模型
+ * @return {Object} 返回视图所用模型
+ */
+ViewModel.prototype.js = async function(model) {
+	var js = {
+		data: [],
+		query: []
+	};
+	var field = model.field;
+	var path_start = model.file.indexOf('admin') !== -1 ? '/apis/' : '/api/';
+
+	for (var i = 0; i < field.length; i++) {
+		var o = field[i];
+		var format = o.format;
+		if (format) {
+			var obj;
+			if (format.table) {
+				var basename = format.table.split('_').splice(1).join('_');
+				var name = "list_" + basename;
+				var id = format.id || format.key;
+				o.label = name;
+				var path = path_start + format.table.replace('_', '/') + "?size=0";
+				obj = {
+					basename,
+					title: format.title,
+					id,
+					name,
+					field: format.name,
+					value: [],
+					path
+				};
+
+				// 存在BUG（start）
+				if (o.name === 'father_id' || o.name === 'fid') {
+					obj.father_id = o.name;
+				}
+				if (o.name === 'title') {
+					obj.title_name = 'title';
+				}
+				// 存在BUG（end）
+			} else {
+				var basename = format.key;
+				var name = "arr_" + basename;
+				o.label = name;
+				obj = {
+					title: format.title,
+					name,
+					value: format.list
+				}
+			}
+			js.data.push(obj);
+		}
+	}
+	var param = model.param;
+	if (param && param.get) {
+		var arr = param.get.query_required.concat(param.get.query);
+		var lt = param.list;
+		for (var i = 0; i < arr.length; i++) {
+			var o = lt.getObj({
+				name: arr[i]
+			});
+			if (o) {
+				js.query.push({
+					title: o.title,
+					name: o.name,
+					type: o.type,
+					select: o.description ? (o.description.indexOf('(') !== -1) : false
+				});
+			}
+		}
+	}
+	return js;
+};
+
+/**
+ * 运算视图模型
+ * @param {Object} model 模型
+ * @return {Object} 返回视图所用模型
+ */
+ViewModel.prototype.run = async function(model) {
+	model.field = await this.field(model);
+	model.js = await this.js(model);
+	model.html = await this.html(model);
+	model.css = await this.css(model);
+	return model;
+};
+
+module.exports = ViewModel;

package/{bin → core}/com/param/config.tpl.json

@@ -3,26 +3,48 @@
 	"filter": true,
 	// 校验脚本文件, 可以使用脚本的方式加一步进行校验, 让传参更加安全
 	"func_file": "",
+	// get请求
+	"get": {
+		// 查询参数校验项
+		"query": ["uid", "name", "username", "phone", "email"],
+		// 查询必填参数
+		"query_required": []
+	},
+	// post请求
 	"post": {
+		// 查询参数校验项
 		"query": ["uid", "name", "username", "phone", "email"],
+		// 查询必填参数
 		"query_required": [],
+		// 正文参数校验项
 		"body": ["age", "headImg", "birthday", "password", "confirm_password", "pay_password"],
+		// 正文必填参数
 		"body_required": []
 	},
+	// 校验列表
 	"list": [{
+			// 参数key名
 			"name": "uid",
+			// 参数中文名
 			"title": "用户ID",
+			// 数据类型
 			"type": "number",
+			// 数字类型时设置
 			"number": {
+				// 最小数值
 				"min": 1
 			},
+			// 分隔参数，允许传多个值，为空则限制1个值
 			"splitter": "|"
 		}, {
 			"name": "name",
 			"title": "姓名",
 			"type": "string",
+			// 字符串类型时设置
 			"string": {
+				// 格式
 				"format": "ch",
+				// 传值范围，字符串时为限制字符长度
 				"range": [2, 6]
 			},
 			"splitter": "|"
@@ -32,6 +54,7 @@
 			"title": "年龄",
 			"type": "number",
 			"number": {
+				// 传值范围，数字时为最小值和最大值
 				"range": [1, 150]
 			}
 		},
@@ -40,6 +63,7 @@
 			"title": "头像",
 			"type": "string",
 			"string": {
+				// 拓展名，用于传媒体（图片、音频、视频）时
 				"extension": "png|gif|jpg|jpeg|bmp"
 			}
 		},

package/{bin → core}/com/param/drive.js

@@ -17,12 +17,14 @@ class Drive extends Item {
 		/* 通用项 */
 		// 配置参数
 		this.config = {
-			// 名称, 由中英文和下“_”组成, 用于卸载接口 例如: demo
+			// 名称, 由中英文和下“_”组成, 用于修改或卸载 例如: demo
 			"name": "",
+			// 状态 0未启用，1启用
+			"state": 1,
 			// 参数过滤
 			"filter": true,
 			// 默认监听方法, 当查询参数中出现监听的关键词时,选择以该键值作为请求方式，否则默认为get
-			"method": "get",
+			"method": "method",
 			// 增
 			"add": {
 				// body参数
@@ -57,19 +59,48 @@ class Drive extends Item {
 				// query中的必填参数
 				"query_required": []
 			},
-			// 提交
-			"post": {
+			// 导入
+			"import": {
+				// body中的参数
+				"body": ["name"],
+				// body中的必填参数
+				"body_required": ["file"]
+			},
+			// 导出
+			"export": {
 				// url中的query参数
 				"query": [],
 				// query中的必填参数
-				"query_required": [],
-				// body参数
-				"body": [],
-				// body中的必填参数
-				"body_required": [],
-				// 不包含参数
-				"body_not": []
+				"query_required": []
+			},
+			// 去重
+			"del_req": {
+				// query中的必填参数
+				"query_required": ["groupby", "sort"]
+			},
+			// 合计
+			"sum": {
+				// query中的必填参数
+				"query_required": ["field", "groupby"]
 			},
+			// 总数
+			"count": {
+				// query中的必填参数
+				"query_required": ["field", "groupby"]
+			},
+			// 提交
+			// "post": {
+			// 	// url中的query参数
+			// 	"query": [],
+			// 	// query中的必填参数
+			// 	"query_required": [],
+			// 	// body参数
+			// 	"body": [],
+			// 	// body中的必填参数
+			// 	"body_required": [],
+			// 	// 不包含参数
+			// 	"body_not": []
+			// },
 			// 验证参数集
 			"list": [],
 			// 文件路径, 当调用函数不存在时，会先从文件中加载
@@ -149,7 +180,8 @@ Drive.prototype.model = function() {
 			"max": 0,
 			// 验证字符串范围
 			"range": []
-		}
+		},
+		"default": ""
 	});
 };
 
@@ -162,7 +194,7 @@ Drive.prototype.model = function() {
  */
 Drive.prototype.check_item = function(model, value, method) {
 	var msg;
-	if (value === undefined || value === null) {
+	if (value === "" || value === undefined || value === null) {
 		if (method.has(model.name)) {
 			msg = model.msg_head(model) + model.msg('required');
 		}
@@ -272,7 +304,7 @@ Drive.prototype.check = function(query, body, method) {
 	if (!arr || arr.length === 0) {
 		arr = [];
 		for (var k in query) {
-			if (arr.indexOf(k) == -1) {
+			if (arr.indexOf(k) === -1) {
 				arr.push(k);
 			}
 		}
@@ -294,7 +326,7 @@ Drive.prototype.check = function(query, body, method) {
 		if (!arr || arr.length === 0) {
 			arr = [];
 			for (var k in query) {
-				if (arr.indexOf(k) == -1) {
+				if (arr.indexOf(k) === -1) {
 					arr.push(k);
 				}
 			}

package/core/com/plugin/com.json

@@ -0,0 +1,4 @@
+{
+	"name": "插件管理器",
+	"script": "./index.js"
+}

package/core/com/plugin/config.tpl.json

@@ -0,0 +1,20 @@
+{
+	// 应用名称，表示该插件用在什么应用里的
+	"app": "{1}",
+	// 插件名称，插件的唯一标识
+	"name": "{0}",
+	// 插件标题，用于检索和识别
+	"title": "示例插件",
+	// 插件描述，介绍改插件是做什么用的
+	"description": "描述该插件是做什么用的",
+	// 插件版本号，用于升级迭代
+	"version": "1.0",
+	// 插件语言包文件路径
+	"lang_path": "./lang/",
+	// 插件图标
+	"icon": "/{1}/{0}/img/logo.png",
+	// 插件指令，通过指令方式调用插件
+	"cmd": "{2}",
+	// 排序，表示多个插件时在应用下执行的先后顺序
+	"sort": 10
+}

package/{bin → core}/com/plugin/drive.js

@@ -14,11 +14,6 @@ class Drive extends Item {
 	constructor(dir) {
 		super(dir, __dirname);
 		this.default_file = "./plugin.json";
-
-		/**
-		 * 开关，开启可使用插件
-		 */
-		this.onOff = true;
 		
 		/**
 		 * 当前语言
@@ -32,13 +27,15 @@ class Drive extends Item {
 		/* 通用项 */
 		// 配置参数
 		this.config = {
+			// 名称, 由中英文和下“_”组成, 用于修改或卸载 例如: demo
+			// 同时也是版本唯一标识，当商城有两个插件名称相同时，可以通过版本号查询和下载
+			"name": "",
+			// 状态 0未启用，1启用
+			"state": 1,
 			// 标题, 介绍事件作用
 			"title": "",
 			// 描述, 用于描述该事件有什么用的
 			"description": "",
-			// 名称, 由中英文和下“_”组成, 用于卸载事件
-			// 同时也是版本唯一标识，当商城有两个插件名称相同时，可以通过版本号查询和下载
-			"name": "",
 			// 应用域
 			"app": "",
 			// 文件路径, 当调用函数不存在时，会先从文件中加载

package/{bin → core}/com/plugin/index.js

@@ -31,7 +31,7 @@ Plugin.prototype.run = function(param1, param2) {
 	var ret;
 	var lt = this.list;
 	for (var i = 0, o; o = lt[i++];) {
-		if (o.onOff) {
+		if (o.config.state === 1) {
 			ret = o.run(param1, param2);
 			if (ret && o.end) {
 				break;
@@ -56,7 +56,7 @@ Plugin.prototype.chat = async function(from_user, to_user, group, content, type,
 	var ret = "";
 	var lt = this.list;
 	for (var i = 0, o; o = lt[i++];) {
-		if (o.onOff) {
+		if (o.config.state === 1) {
 			ret = await o.chat(from_user, to_user, group, content, type, msg_type, db);
 			if (ret) {
 				break;
@@ -66,29 +66,6 @@ Plugin.prototype.chat = async function(from_user, to_user, group, content, type,
 	return ret;
 };
 
-/**
- * 指令（类似命令提示符）
- * @param {String} content 指令内容
- * @return {String} 执行结果
- */
-Plugin.prototype.cmd = async function(content) {
-	var ret = "";
-	var lt = this.list;
-	for (var i = 0, o; o = lt[i++];) {
-		if (o.onOff) {
-			var cmd = o.config.cmd;
-			if (cmd && content.startsWith(cmd)) {
-				ret = await o.cmd(content.replace(cmd, ''));
-				if (ret) {
-					break;
-				}
-			}
-		}
-	}
-	return ret;
-};
-
-
 /**
  * 执行插件方法
  * @param {String} name 插件名称
@@ -101,7 +78,7 @@ Plugin.prototype.exec = function(name, method, option) {
 	var lt = this.list;
 	for (var i = 0, o; o = lt[i++];) {
 		var name = o.config.name;
-		if (o.onOff && name === name) {
+		if (o.config.state === 1 && name === name) {
 			var func = o[method];
 			if (func) {
 				ret = func(option);
@@ -137,16 +114,16 @@ Plugin.prototype.sort = function() {
  */
 Plugin.prototype.load = function(path) {
 	if (!path) {
-		path = '/app/' + this.scope + "/plugin/";
+		path = '/app/' + this.scope;
 	}
-	var list = this.list;
-	if (path.endsWith('/app/')) {
-		var list_scope = $.dir.get(path);
+	list = this.list;
+	var dir_plugin = path + "/plugin/";
+	if (dir_plugin.hasDir()) {
+		var list_scope = $.dir.get(dir_plugin);
 
 		// 遍历目录路径
-
 		list_scope.map(function(o) {
-			var file = './app.json'.fullname(o);
+			var file = './plugin.json'.fullname(o);
 			if (file.hasFile()) {
 				var obj = new Drive(o);
 				obj.load(file);
@@ -155,27 +132,10 @@ Plugin.prototype.load = function(path) {
 				}
 			}
 		});
-	} else {
-		var dir_plugin = path + "/plugin/";
-		if (dir_plugin.hasDir()) {
-			var list_scope = $.dir.get(dir_plugin);
-
-			// 遍历目录路径
-			list_scope.map(function(o) {
-				var file = './plugin.json'.fullname(o);
-				if (file.hasFile()) {
-					var obj = new Drive(o);
-					obj.load(file);
-					if (obj.config.name) {
-						list.push(obj);
-					}
-				}
-			});
-		}
 	}
 };
 
-exports.Plugin = Plugin;
+module.exports = Plugin;
 
 
 /**
@@ -191,7 +151,7 @@ if (!$.pool.plugin) {
  * @param {string} title 标题
  * @return {Object} 返回一个缓存类
  */
-function plugin_admin(scope, title) {
+$.plugin_admin = function (scope, title) {
 	if (!scope) {
 		scope = $.val.scope + '';
 	}
@@ -202,8 +162,3 @@ function plugin_admin(scope, title) {
 	}
 	return obj;
 }
-
-/**
- * @module 导出plugin管理器
- */
-exports.plugin_admin = plugin_admin;

package/core/com/socket/README.md

@@ -0,0 +1,47 @@
+# websocket 开发说明
+
+## 简介
+Websocket 是用于与浏览器客户端实现双向通讯的协议，可用来实现即时通讯、交易所、消息推送等。
+
+## 关于mm websocket的使用
+前端和服务端均已集成webstock功能，前端使用mm_sdk，后端使用com/websocket框架机制
+
+## websocket 使用规范
+为了让前后端通讯更加稳定、可控，前后端均采用json-rpc2.0的方式进行通讯，采用以下传参规范 ↓
+
+在客户端给服务端发送消息时，或在服务端给客户端发送消息时（响应格式）:
+`
+	{
+		// 消息ID (用于识别对应请求)
+		id: "",
+		// 调用方法 (例如聊天时为chat、请求获取联系人时为get_contact)
+		method: "",
+		// 请求参数
+		params: {}
+	}
+`
+
+如果需要在某一端接收到消息后，告诉对方已收到消息或返回内容，可以给对方端推送一条消息（响应格式）:
+`
+	{
+		// 消息ID (用于响应对应请求)
+		id: "",
+		// 错误提示 (错误时必须返回)
+		error: {
+			// 错误码
+			code: -32602,
+			// 错误提示
+			message: ""
+		},
+		// 响应结果 (成功时必须返回)
+		result: {}
+	}
+`
+
+## mm websocket 通讯json-rpc2.0协议原理
+	1. 首先websocket给客户端和服务端提供了一个接收消息的接口，可以收到来自对方的消息
+	2. 然后双方可以通过收到的json数据中是否含有method属性来判断对方端是请求查询，还是提交数据
+	3. 如果是提交数据，则接收数据处理并存储
+	4. 如果是请求查询，则给请求做处理，并回推送一条消息
+	5. 为了能够识别消息是否成功推送，通过响应格式中的ID属性来判断
+	6. 如果非请求或响应, 只是单向推送数据, 那么可以通过id属性值0或空进行识别

package/core/com/socket/com.json

@@ -0,0 +1,4 @@
+{
+	"name": "web socket管理器",
+	"script": "./index.js"
+}