mm_os 2.7.9 → 2.8.1

package/README.md

@@ -1,7 +1,7 @@
 # 服务端框架
 
 #### 介绍
-这是一个服务端框架，用于快速构建网站、游戏、小程序服务端。
+这是一个服务端框架，用于快速构建网站、游戏、小程序、AIOT服务端。
 
 #### 软件架构
 由koa网站框架 + art-template模板引擎 + mm(热拔插)插件机制 + mysql数据库 + redis缓存 + jwt鉴权 + 等等组成。

package/demo/app/dev/README.md

@@ -0,0 +1 @@
+## 开发者工具

package/demo/app/dev/app.js

@@ -0,0 +1,149 @@
+/**
+ * @fileOverview dev
+ * @author <a href="作者主页地址">插件作者</a>
+ * @version 1.0
+ */
+
+
+
+/**
+ * @description 插件对象
+ */
+module.exports = {
+	/**
+	 * @description 初始化
+	 * @param {Object} option 配置参数
+	 * @return {String} 成功返回null, 否则返回错误提示
+	 */
+	init(option) {
+		// 创建插件
+		this.plugin = $.plugin_admin('dev');
+		this.plugin.update(__dirname);
+		var msg = null;
+		return msg;
+	},
+
+	/**
+	 * @description 安装
+	 * @param {Object} option 配置参数
+	 * @return {String} 成功返回null,否则返回错误提示
+	 */
+	install(option) {
+		var msg = null;
+		return msg;
+	},
+
+	/**
+	 * @description 卸载
+	 * @param {Object} option 配置参数
+	 * @return {String} 成功返回null,否则返回错误提示
+	 */
+	uninstall(option) {
+		var msg = null;
+		return msg;
+	},
+
+	/**
+	 * @description 更新
+	 * @param {Object} option 配置参数
+	 * @return {String} 成功返回null, 否则返回错误提示
+	 */
+	update(option) {
+		var msg = null;
+		return msg;
+	},
+
+	/**
+	 * @description 启动
+	 * @param {Object} opiton 配置参数
+	 * @return {String} 成功返回null,否则返回错误提示
+	 */
+	start(option) {
+		var msg = null;
+		return msg;
+	},
+
+	/**
+	 * @description 暂停
+	 * @param {Object} opiton 配置参数
+	 * @return {String} 成功返回null,否则返回错误提示
+	 */
+	stop(option) {
+		var msg = null;
+		return msg;
+	},
+
+	/**
+	 * @description 结束
+	 * @param {Object} opiton 配置参数
+	 * @return {String} 成功返回null,否则返回错误提示
+	 */
+	end(option) {
+		var msg = null;
+		return msg;
+	},
+
+	/**
+	 * @description 插件
+	 * @param {String} item 插件项
+	 * @return {Object} 旗下插件和信息
+	 */
+	help(item) {
+		var tip = "";
+		switch (item) {
+			case "run":
+				break;
+			default:
+				break;
+		}
+		return tip;
+	},
+
+	/**
+	 * @description 主程序
+	 * @param {Object} param1 参数1
+	 * @param {Object} param2 参数2
+	 * @return {Object} 返回执行结果
+	 */
+	main(param1, param2) {
+		var ret = null;
+		return ret;
+	},
+
+	/**
+	 * @description 指令（类似命令提示符）
+	 * @param {String} content 指令内容
+	 * @return {String} 执行结果
+	 */
+	cmd(content) {
+		var ret = "";
+		return ret;
+	},
+
+	/**
+	 * @description API接口（用于其他插件调用该插件时）
+	 * @param {Object} ctx HTTP上下文
+	 * @param {Object} db 数据库管理器
+	 * @return {Object} 执行结果
+	 */
+	api(ctx, db) {
+		var ret = "";
+		return ret;
+	},
+
+	/**
+	 * @description 聊天（通过聊天的方式驱动插件, 用于机器人开发）
+	 * @param {String} from_user 发送消息人
+	 * @param {String} to_user 接收消息人
+	 * @param {String} content 内容
+	 * @param {String} group 群组 如果是个人，群组为空
+	 * @param {Number} type 群类型, 1永久会话/群、2临时会话/群
+	 * @param {String} msg_type 消息类型, event事件型、message消息型。默认消息型
+	 * @param {Object} 数据管理器
+	 * @return {String} 回复内容
+	 */
+	async chat(from_user, to_user, group, content, type, msg_type, db) {
+		var ret = "";
+		return ret;
+	}
+};

package/demo/app/dev/app.json

@@ -0,0 +1,12 @@
+{
+    "name": "dev",
+    "title": "开发者",
+    "description": "该应用便于开发和管理飞鸟云算力服务端，可管理“应用、插件、事件、接口、任务、数据库”等",
+    "version": "1.0",
+    "identifier": "dev",
+    "lang_path": "./lang/",
+    "icon": "/dev/img/logo.png",
+    "script": "./app.js",
+    "sort": 10,
+    "state": 1
+}

package/demo/app/dev/event_api/client/event.json

@@ -0,0 +1,11 @@
+{
+	"target": "/api/dev*",
+	"name": "dev_client",
+	"title": "开发者客户端调用的接口事件",
+	"description": "用于开发者访问服务端时调用的接口",
+	"stage": "main",
+	"state": 1,
+	"func_file": "./main.js",
+	"sort": 99,
+	"end": true
+}

package/demo/app/dev/event_api/client/main.js

@@ -0,0 +1,19 @@
+var api = $.api_admin('dev_client', '开发者专用');
+// 首次启动更新api接口;
+api.update('dev/');
+
+var sql = $.mysql_admin('sys', __dirname);
+
+/**
+ * @description 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 在这定义要访问的数据库 (分布式开发时设置不同的数据库名)
+	$.push(db, sql.db(), true);
+	return api.run(ctx, db);
+};
+
+exports.main = main;

package/demo/app/dev/event_api/manage/event.json

@@ -0,0 +1,19 @@
+[{
+	// 目标对象
+	"target": "/apis/dev*",
+	// 事件名称, 用于动态增删改
+	"name": "dev_manage",
+	// 标题, 用于开发者查看事件
+	"title": "示例事件",
+	// 描述, 用于介绍该事件是做什么用的
+	"description": "描述事件使用方法",
+	// 阶段, 分执行前before、验证check、主要main、渲染render、执行后after阶段
+	"stage": "main",
+	"state": 1,
+	// 响应方法 GET请求、POST请求、ALL所有请求，如果非API事件可自定义
+	"method": "ALL",
+	// 函数文件, 当事件触发时执行指定的脚本
+	"func_file": "./main.js",
+	// 执行顺序, 数值越小越优先执行
+	"sort": 100
+}]

package/demo/app/dev/event_api/manage/main.js

@@ -0,0 +1,26 @@
+// 使用api管理器
+var api = $.api_admin('dev_manage', 'dev_manage');
+// 首次启动更新api接口;
+api.update();
+
+// 使用mysql数据库管理器
+var sql = $.mysql_admin('sys', __dirname);
+// sql.setConfig($.config.mysql);
+// sql.open();
+
+/**
+ * @description 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 使用模板引擎
+	db.tpl = new $.Tpl();
+	
+	// 在这定义要访问的数据库 (分布式开发时设置不同的数据库名)
+	$.push(db, sql.db(), true);
+	return api.run(ctx, db);
+};
+
+exports.main = main;

package/demo/app/dev/plugin/doc/static/api_list.html

@@ -0,0 +1,144 @@
+<!DOCTYPE html>
+<html lang="zh">
+	<head>
+		<meta charset="utf-8">
+		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+		<meta http-equiv="X-UA-Compatible" content="IE=edge">
+		<meta http-equiv="x-dns-prefetch-control" content="on">
+		<meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no,viewport-fit=cover">
+		<meta name="format-detection" content="telephone=no">
+		<meta name="apple-mobile-web-app-capable" content="yes">
+		<meta name="apple-mobile-web-app-status-bar-style" content="black">
+		<meta name="description" content="这是web API文档">
+		<meta name="keywords" content="开发文档">
+		<meta name="author" content="邱文武">
+
+		<!-- 加载CSS样式 -->
+		<link rel="stylesheet" href="/css/font-awesome.min.css" async />
+		<link rel="stylesheet" href="/css/mm_base.css" async />
+		<link rel="stylesheet" href="/css/mm_layout.css" async />
+		<link rel="stylesheet" href="/css/mm_common.css" async />
+		<link rel="stylesheet" href="/css/mm_component.css" async />
+		<link rel="stylesheet" href="/css/mm_theme.css" async />
+
+		<!-- 加载JS脚本 -->
+		<script src="/js/jquery.min.js"></script>
+		<script src="/js/clipboard.min.js" async></script>
+		<script src="/js/vue.js"></script>
+		<script src="/js/mm_sdk.js"></script>
+
+		<title>接口列表</title>
+		<style>
+			body {
+				background: #fff;
+			}
+
+			main {
+				padding: 2rem;
+			}
+
+			#app h4 {
+				padding-bottom: 0.5rem;
+				border-bottom: 1px solid rgba(125, 125, 125, 0.25);
+				margin-bottom: 1rem;
+			}
+
+			.scope_list {
+				padding-left: 2rem;
+			}
+
+			.desc {
+				margin-bottom: 2rem;
+			}
+
+			.mm_btn {
+				border: 1px solid var(--color_border);
+			}
+
+			h4 a {
+				font-size: 0.875rem;
+				padding-top: 0.5rem;
+			}
+		</style>
+	</head>
+	<body>
+		<div id="app">
+			<div class="mm_page">
+				<main>
+					<div class="mm_warp">
+						<h4>API接口文档 —— <span>列表</span> <a class="fr" href="./">选择域</a></h4>
+						<p class="desc">所有的API接口都作用在不同的域下，您可以点击以下域，访问该域下的接口列表</p>
+						<table class="mm_table table-hover" v-if="list.length">
+							<thead>
+								<tr>
+									<th>#</th>
+									<th width="200">名称</th>
+									<th width="200">标题</th>
+									<th>描述</th>
+									<th width="80">操作</th>
+								</tr>
+							</thead>
+							<tbody>
+								<tr v-for="(o, k) in list" :key="k">
+									<th>{{ k + 1 }}</th>
+									<td><a :href="'./api_view.html?scope=' + query.scope + '&name=' + o.name">{{ o.name }}</a></td>
+									<td>{{ o.title }}</td>
+									<td>{{ o.description }}</td>
+									<td><a class="mm_btn btn_info-x" :href="'./api_view.html?scope=' + query.scope + '&name=' + o.name">查看</a></td>
+								</tr>
+							</tbody>
+						</table>
+						<div v-else class="desc center">
+							该域下没有定义API接口
+						</div>
+					</div>
+				</main>
+			</div>
+		</div>
+		<script>
+			var vue = new Vue({
+				el: '#app',
+				data() {
+					return {
+						url: "/api/dev_api?",
+						query: {
+							scope: "client"
+						},
+						list: []
+					}
+				},
+				methods: {
+					get_list() {
+						var _this = this;
+						$.http.get(this.url + $.toUrl(this.query), function(json, status) {
+							_this.get_list_after(json);
+						});
+					},
+					get_list_after(json) {
+						if (json.result) {
+							var list = this.list;
+							list.clear();
+							list.addList(json.result.list);
+						}
+					}
+				},
+				created() {
+					var arr = location.search.split("&");
+					var len = arr.length;
+					if (len > 0) {
+						for (var i = 0; i < len; i++) {
+							var o = arr[i];
+							if (o.indexOf('scope') !== -1) {
+								var ar = o.split("=");
+								if (ar.length > 1) {
+									this.query.scope = ar[1];
+								}
+							};
+						}
+					}
+					this.get_list();
+				}
+			});
+		</script>
+	</body>
+</html>