mm_os 2.8.0 → 2.8.1

package/demo/app/dev/plugin/main/api_dev_client/nav/index.js

@@ -0,0 +1,36 @@
+const dev = require('../com.js').dev;
+
+var dev_class = new dev('nav');
+
+/**
+ * @description 更新配置文件
+ * @param {Object} req HTTP上文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+dev_class.update_vue = async function(req, db) {
+	var q = req.query;
+	var scope = q["scope"];
+	var pool = $.pool.nav[scope];
+	if(!pool)
+	{
+		return $.ret.error(10000, scope + '作用域(scope) 不存在！');
+	}
+	var msg = await pool.update_vue(q);
+	if (msg) {
+		return $.ret.bl(false, msg);
+	} else {
+		return $.ret.bl(true, '更新成功');
+	}
+};
+
+/**
+ * @description 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+exports.main = async function(ctx, db) {
+	this.type = "nav";
+	return await dev_class.main(ctx, db);
+};

package/demo/app/dev/plugin/main/api_dev_client/nav/param.json

@@ -0,0 +1,36 @@
+{
+	"name": "dev_nav",
+	
+	"get": {
+		"query": [
+			"method",
+			"name"
+		],
+		"query_required": ["scope"]
+	},
+	"list": [{
+			"name": "method",
+			"title": "执行方式",
+			"description": "add增、del删、get改、set查、update更新、load载入、save保存、update_vue更新VUE文件，update_mvc更新模板页面",
+			"type": "string"
+		},
+		{
+			"name": "scope",
+			"title": "作用域",
+			"description": "一般为sys系统，自定义机制输入自定义作用域名",
+			"type": "string"
+		},
+		{
+			"name": "name",
+			"title": "名称",
+			"description": "选择要操作的配置文件名称",
+			"type": "string"
+		},
+		{
+			"name": "path",
+			"title": "名称",
+			"description": "选择要操作的配置文件名称",
+			"type": "string"
+		}
+	]
+}

package/demo/app/dev/plugin/main/api_dev_client/plugin/api.json

@@ -0,0 +1,10 @@
+{
+	"path": "/api/dev_plugin",
+	"type": "api",
+	"name": "dev_plugin_main",
+	"title": "管理插件的接口",
+	"cache": 0,
+	"func_file": "./index.js",
+	"method": "ALL",
+	"param_path": "./param.json"
+}

package/demo/app/dev/plugin/main/api_dev_client/plugin/index.js

@@ -0,0 +1,13 @@
+const dev = require('../com.js').dev;
+
+var dev_class = new dev('plugin');
+
+/**
+ * @description 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+exports.main = async function(ctx, db){
+	return await dev_class.main(ctx, db);
+};

package/demo/app/dev/plugin/main/api_dev_client/plugin/param.json

@@ -0,0 +1,31 @@
+{
+	"name": "dev_plugin",
+	
+	"get": {
+		"query": [
+			"method",
+			"scope",
+			"name"
+		],
+		"query_required": []
+	},
+	"list": [{
+			"name": "method",
+			"title": "执行方式",
+			"description": "add增、del删、get改、set查、update更新、load载入、save保存",
+			"type": "string"
+		},
+		{
+			"name": "scope",
+			"title": "作用域",
+			"description": "一般为sys系统，自定义机制输入自定义作用域名",
+			"type": "string"
+		},
+		{
+			"name": "name",
+			"title": "名称",
+			"description": "选择要操作的配置文件名称",
+			"type": "string"
+		}
+	]
+}

package/demo/app/dev/plugin/main/api_dev_client/source/api.json

@@ -0,0 +1,10 @@
+{
+	"path": "/api/dev_source",
+	"type": "api",
+	"name": "dev_source_main",
+	"title": "管理资源的接口",
+	"cache": 0,
+	"func_file": "./index.js",
+	"method": "ALL",
+	"param_path": "./param.json"
+}

package/demo/app/dev/plugin/main/api_dev_client/source/index.js

@@ -0,0 +1,14 @@
+/**
+ * @description 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 获取请求参数
+	var req = ctx.request;
+	var q = req.query;
+	return "hello world" + JSON.stringify(q);
+};
+
+exports.main = main;

package/demo/app/dev/plugin/main/api_dev_client/source/param.json

@@ -0,0 +1,31 @@
+{
+	"name": "dev_source",
+	
+	"get": {
+		"query": [
+			"method",
+			"scope",
+			"name"
+		],
+		"query_required": []
+	},
+	"list": [{
+			"name": "method",
+			"title": "执行方式",
+			"description": "add增、del删、get改、set查、update更新、load载入、save保存",
+			"type": "string"
+		},
+		{
+			"name": "scope",
+			"title": "作用域",
+			"description": "一般为sys系统，自定义机制输入自定义作用域名",
+			"type": "string"
+		},
+		{
+			"name": "name",
+			"title": "名称",
+			"description": "选择要操作的配置文件名称",
+			"type": "string"
+		}
+	]
+}

package/demo/app/dev/plugin/main/api_dev_client/sql/api.json

@@ -0,0 +1,10 @@
+{
+	"path": "/api/dev_sql",
+	"type": "api",
+	"name": "dev_sql_main",
+	"title": "管理SQL模板的接口",
+	"cache": 0,
+	"func_file": "./index.js",
+	"method": "ALL",
+	"param_path": "./param.json"
+}

package/demo/app/dev/plugin/main/api_dev_client/sql/index.js

@@ -0,0 +1,13 @@
+const dev = require('../com.js').dev;
+
+var dev_class = new dev('sql');
+
+/**
+ * @description 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+exports.main = async function(ctx, db){
+	return await dev_class.main(ctx, db);
+};

package/demo/app/dev/plugin/main/api_dev_client/sql/param.json

@@ -0,0 +1,31 @@
+{
+	"name": "dev_sql",
+	
+	"get": {
+		"query": [
+			"method",
+			"scope",
+			"name"
+		],
+		"query_required": []
+	},
+	"list": [{
+			"name": "method",
+			"title": "执行方式",
+			"description": "add增、del删、get改、set查、update更新、load载入、save保存",
+			"type": "string"
+		},
+		{
+			"name": "scope",
+			"title": "作用域",
+			"description": "一般为sys系统，自定义机制输入自定义作用域名",
+			"type": "string"
+		},
+		{
+			"name": "name",
+			"title": "名称",
+			"description": "选择要操作的配置文件名称",
+			"type": "string"
+		}
+	]
+}

package/demo/app/dev/plugin/main/api_dev_client/task/api.json

@@ -0,0 +1,16 @@
+{
+    "name": "dev_task_main",
+    "title": "管理任务的接口",
+    "description": "暂无描述",
+    "path": "/api/dev_task",
+    "type": "api",
+    "contentType": "json",
+    "func_file": "./index.js",
+    "func_name": "",
+    "method": "ALL",
+    "cache": 0,
+    "client_cache": false,
+    "param_path": "./param.json",
+    "sql_path": "",
+    "check_param": true
+}

package/demo/app/dev/plugin/main/api_dev_client/task/index.js

@@ -0,0 +1,13 @@
+const dev = require('../com.js').dev;
+
+var dev_class = new dev('task');
+
+/**
+ * @description 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+exports.main = async function(ctx, db){
+	return await dev_class.main(ctx, db);
+};

package/demo/app/dev/plugin/main/api_dev_client/task/param.json

@@ -0,0 +1,31 @@
+{
+	"name": "dev_task",
+	
+	"get": {
+		"query": [
+			"method",
+			"scope",
+			"name"
+		],
+		"query_required": []
+	},
+	"list": [{
+			"name": "method",
+			"title": "执行方式",
+			"description": "add增、del删、get改、set查、update更新、load载入、save保存",
+			"type": "string"
+		},
+		{
+			"name": "scope",
+			"title": "作用域",
+			"description": "一般为sys系统，自定义机制输入自定义作用域名",
+			"type": "string"
+		},
+		{
+			"name": "name",
+			"title": "名称",
+			"description": "选择要操作的配置文件名称",
+			"type": "string"
+		}
+	]
+}

package/demo/app/dev/plugin/main/api_dev_client/translate/api.json

@@ -0,0 +1,39 @@
+{
+	// 路由路径
+	"path": "/api/dev/translate",
+	// 名称, 用于动态增删改API配置
+	"name": "dev_translate",
+	// 标题, 用于开发文档显示
+	"title": "示例接口",
+	// 描述, 用于介绍该路由的作用
+	"description": "描述接口使用方法",
+	// 函数文件, 用于驱动脚本, 实现业务 
+	"func_file": "./index.js",
+	// 请求方法, 选填 GET, POST, ALL。 ALL指同时支持GET/POST
+	"method": "ALL",
+	// 开放域, 如果域未开放, 则只有特定的协议头才能访问该API, 同时API文档不接见
+	"scope": true,
+	// 缓存时长, 单位: 分钟。使用缓存后, 二次访问API直接从缓存读取, 不重复执行业务脚本
+	"cache": 0,
+	// 是否客户端缓存, 使用客户端则不再访问服务器, 直接从浏览器中拿; 使用服务端缓存则会访问服务器   
+	"client_cache": false,
+	// SQL配置路径, 用于将请求参数拼接成SQL, 实现比较复杂的查询
+	"sql_path": "./sql.json",
+	// 参数配置路径, 用于校验API请求参数是否正确, 同时显示在API文档中 
+	"param_path": "./param.json",
+	/* 授权协议 */
+	"oauth": {
+		// 是否需要登录, true表示需要登录才能访问该接口
+		"signIn": false,
+		// 会员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"vip": 0,
+		// 管理员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"gm": 0,
+		// 商户/第三方权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"mc": 0,
+		// 用户组, 允许访问该接口的普通用户群体, 传ID数组，例如: [1,5]
+		"user_group": [],
+		// 管理组, 允许访问该接口的管理员群体, 传ID数组，例如: [1,5]
+		"user_admin": []
+	}
+}

package/demo/app/dev/plugin/main/api_dev_client/translate/index.js

@@ -0,0 +1,43 @@
+// 集合路由、导航，不开发前端的情况下可以将以下2行注释掉
+// const nav = $.nav_admin('{0}');
+// nav.update();
+
+/**
+ * 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 获取请求参数
+	var req = ctx.request;
+	var q = req.query;
+	var {
+		word
+	} = q;
+	db.table = "dev_dict";
+	var obj = await db.getObj({ zh: word });
+	if(obj){
+		return {
+			result: obj.en
+		}
+	}
+	else {
+		var ret = await $.translate(word);
+		var json = ret.result;
+		if (json) {
+			var en = json.dst.toLowerCase().replace(/ /g, "_").replace(/'s/g, "").replace(/-/g, "_").replace(/\./g, "").replace(/\?/g, "");
+			db.add({ zh: word, en });
+			return {
+				result: en
+			}
+		}
+		else {
+			return ret;
+		}
+	};
+};
+
+$.translate_main = main;
+
+exports.main = main;

package/demo/app/dev/plugin/main/api_dev_client/translate/param.json

@@ -0,0 +1,130 @@
+{
+	// 是否启用过滤, 启用过滤后, 不符合的参数会被过滤掉
+	"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": "|"
+		},
+		{
+			"name": "age",
+			"title": "年龄",
+			"type": "number",
+			"number": {
+				// 传值范围，数字时为最小值和最大值
+				"range": [1, 150]
+			}
+		},
+		{
+			"name": "headImg",
+			"title": "头像",
+			"type": "string",
+			"string": {
+				// 拓展名，用于传媒体（图片、音频、视频）时
+				"extension": "png|gif|jpg|jpeg|bmp"
+			}
+		},
+		{
+			"name": "birthday",
+			"title": "生日",
+			"type": "string",
+			"string": {
+				"format": "dateISO"
+			}
+		},
+		{
+			"name": "username",
+			"title": "用户名",
+			"type": "string",
+			"string": {
+				"format": "username"
+			}
+		},
+		{
+			"name": "password",
+			"title": "密码",
+			"type": "string",
+			"string": {
+				"format": "password",
+				"different": "username"
+			}
+		},
+		{
+			"name": "phone",
+			"title": "手机",
+			"type": "string",
+			"string": {
+				"format": "phone"
+			}
+		},
+		{
+			"name": "email",
+			"title": "邮箱",
+			"type": "string",
+			"string": {
+				"format": "email"
+			}
+		},
+		{
+			"name": "pay_password",
+			"title": "支付密码",
+			"type": "string",
+			"string": {
+				"format": "num",
+				"different": "password"
+			}
+		},
+		{
+			"name": "confirm_password",
+			"title": "确认密码",
+			"type": "string",
+			"string": {
+				"format": "password",
+				"identical": "password"
+			}
+		}
+	]
+}

package/demo/app/dev/plugin/main/api_dev_client/translate/sql.json

@@ -0,0 +1,62 @@
+{
+	// SQL模板标题
+	"title": "示例sql模板",
+	// 调用的数据表
+	"table": "user_account",
+	// 表主键，用于getObj查询时
+	"key": "user_id",
+	// 排序方式，{0}表示支持前端传值来排序，传值方式例如：orderby=user_id
+	"orderby": "{0}",
+	// 默认排序方式，当前端没有传值的情况下，采用默认传值方式
+	"orderby_default": "`user_id` desc",
+	// 查询列表时返回的字段，{0}表示支持前端传值
+	"field": "{0}",
+	// 查询对象时返回的字段
+	"field_obj": "{0}",
+	// 默认返回字段
+	"field_default": "`username`, `phone`",
+	// 需要过滤的字段，*代表泛匹配 前面*表示以xxx结尾，后面*表示以xxx开头，前后*表示包含xxx的过滤
+	"field_hide": ["*password*", "*token*"],
+	// 传值分隔符，如果允许多个值，可以通过这个来分割，如果不允许传多个值则设置为空
+	"separator": "|",
+	// 关键词，用于过滤掉这些值不会写到查询条件中，同时用来识别传的参数
+	"keyword": {
+		// 数据表名，当"table":"{0}", 允许识别表明
+		"table": "table",
+		// 排序方式
+		"orderby": "orderby",
+		// 查询的字段
+		"field": "field",
+		// 页码
+		"page": "page",
+		// 页面大小
+		"size": "size",
+		// 总计，返回查询结果总数
+		"count": "count",
+		// 调用方式
+		"method": "method"
+	},
+	// 调用方式 add增 del删 set改 get查 get_obj查一条 import导入 export导出, 支持什么方式就传什么值，支持多个用空格分隔
+	"method": "add del set get get_obj import export del_repeat sum count",
+	// 查询条件转换
+	"query": {
+		// 当username=xx时，转为`username` like '%xxx%'的SQL语法
+		"username": "`username` like '%{0}%'"
+	},
+	// 修改时的查询条件
+	"where": {
+		// 当修改查询条件出现user_id=xx时，转为`user_id` = 'xxx'的SQL语法
+		"user_id": "`user_id` = '{0}'"
+	},
+	// 修改时值转换
+	"update": {
+		// 当修改的正文中出现username是转换为指定格式
+		"username": "`username` = '{0}'"
+	},
+	// SQL执行脚本，当设置js文件名后, 执行该SQL还将调用这个脚本
+	"func_file": "",
+	// 导入导出格式，转换导入、导出Eexcel时字段名和字段值
+	"format": [],
+	// 去重条件，需要查重、并去重的字段在这里写
+	"del_repeat": {}
+}

package/demo/app/dev/plugin/main/api_dev_client/ui/api.json

@@ -0,0 +1,10 @@
+{
+	"path": "/api/dev_ui",
+	"type": "api",
+	"name": "dev_ui_main",
+	"title": "压缩UI组件的接口",
+	"cache": 0,
+	"func_file": "./index.js",
+	"method": "ALL",
+	"param_path": "./param.json"
+}