mm_os 3.3.1 → 4.0.0

package/com/sql/index.js

@@ -0,0 +1,150 @@
+const Manager = require('mm_machine').Manager;
+const Drive = require('./drive');
+
+/**
+ * Sql语句拓展类
+ * @augments {Manager}
+ * @class
+ */
+class Sql extends Manager {
+  /**
+   * 配置参数
+   * @type {object}
+   */
+  static config = {
+    /**
+     * 名称
+     * @type {string}
+     */
+    name: '',
+    /**
+     * 标题
+     * @type {string}
+     */
+    title: 'sql管理',
+    /**
+     * 描述
+     * @type {string}
+     */
+    description: '这是sql管理器',
+    /**
+     * 检索文件名
+     * @type {string}
+     */
+    filename: 'sql.json',
+    /**
+     * 模板目录
+     * @type {string}
+     */
+    tpl_dir: __dirname,
+    /**
+     * 基础目录
+     * @type {string}
+     */
+    base_dir: '../common/sql'.fullname(__dirname),
+    /**
+     * 自定义目录，加载项目自定义资源
+     * @type {string}
+     */
+    dir: './app'.fullname(),
+    /**
+     * 搜索模式 dir按目录搜索 | file按文件名搜索
+     * @type {string}
+     */
+    search_way: 'file',
+    /**
+     * 是否懒加载
+     * @type {boolean}
+     */
+    lazy_load: true,
+    /**
+     * 模式
+     * 1.生产模式，改变文件不会重新加载
+     * 2.热更新模式，改变配置文件会重新加载配置，不重新加载脚本
+     * 3.热重载模式，改变配置文件都会加载配置和脚本
+     * 4.重载模式，执行完后重新加载脚本，避免变量污染
+     * 5.热更新+重载模式，改变配置文件重新加载配置和脚本，执行完后重新加载脚本
+     * @type {number}
+     */
+    mode: 3
+  };
+
+  /**
+   * 构造函数
+   * @param {object} config 配置参数
+   * @param {object} parent 父级模块
+   */
+  constructor(config, parent) {
+    super({ ...Sql.config, ...config }, parent);
+  }
+}
+
+/**
+ * sql驱动类
+ * @type {Drive}
+ */
+Sql.prototype.Drive = Drive;
+
+/**
+ * 排序
+ */
+Sql.prototype.sort = function () {
+  let infos = this.getInfos();
+  infos.sortBy('asc', 'name');
+};
+
+/**
+ * 执行sql
+ * @param {string} name 名称
+ * @param {object} query 查询参数
+ * @param {object} body 修改参数
+ * @param {object} db 数据库管理器 (object) 只支持可用sql语句的数据库
+ * @returns {object} 执行结果
+ */
+Sql.prototype.run = async function (name, query, body, db) {
+  var obj = this.get(name);
+  if (obj) {
+    var ret = await obj.run(query, body, db);
+    if (this.mode > 4) {
+      obj.do('reload');
+    }
+    return ret;
+  }
+  return null;
+};
+
+exports.Sql = Sql;
+
+
+/**
+ * Sql模板池
+ */
+if (!$.pool.sql) {
+  $.pool.sql = {};
+}
+
+/**
+ * Sql管理器,用于创建缓存
+ * @param {string} scope 作用域
+ * @param {string} title 标题
+ * @returns {object} 返回一个缓存类
+ */
+function sqlAdmin(scope, title) {
+  var sc = scope || $.val.scope + '';
+  var obj = $.pool.sql[sc];
+  if (!obj) {
+    $.pool.sql[sc] = new Sql({
+      name: sc,
+      title: title
+    });
+    obj = $.pool.sql[sc];
+  }
+  return obj;
+}
+
+/**
+ * @module 导出Sql管理器
+ */
+if ($.admin) {
+  $.admin.sql = sqlAdmin;
+}

package/com/sql/script.tpl.js

@@ -0,0 +1,47 @@
+
+
+module.exports = {
+  /**
+   * 执行前, 用于过滤参数
+   * @param {object} params 参数对象，包含query和body 如：{ query: {} body: {} }
+   * @returns {object} 过滤后的参数
+   */
+  before(params) {
+    return params;
+  },
+
+  /**
+   * 验证, 用于判断是否执行
+   * @param {object} params 参数对象，包含query和body 如：{ query: {} body: {} }
+   * @returns {boolean} 验证通过返回true, 失败返回false
+   */
+  check(params) {
+    return true;
+  },
+
+  /**
+   * 执行后 可用于附加执行
+   * @param {object} params 参数对象，包含query和body 如：{ query: {} body: {} }
+   * @param {object} sql SQL模板对象
+   * @param {object} ret 最终执行结果
+   * @returns {object} 返回执行结果
+   */
+  after(params, sql, ret) {
+    return ret;
+  },
+
+  /**
+   * 执行主函数
+   * @param {object} params 参数对象，包含query和body 如：{ query: {} body: {} }
+   * @returns {object} 返回执行结果
+   */
+  main(params) {
+    var sql = '';
+    var ret = null;
+
+    return {
+      sql,
+      ret
+    };
+  }
+};

package/com/static/com.json

@@ -0,0 +1,5 @@
+{
+    "name": "Static",
+    "title": "静态文件管理器",
+    "state": 1
+}

package/{core/com → com}/static/config.tpl.json

@@ -1,10 +1,14 @@
 {
 	// 路由路径，注意：这里是泛路径，相当于/*
-	"path": "/",
-	// 默认文件，当直接访问这个路径时，如果存在默认文件，这直接访问该文件
-	"index": "index.html",
+	"path": "${path || '/${name}'}",
+	// 名称, 由中英文和下“_”组成, 用于修改或卸载 例如: demo
+	"name": "${name || 'static'}",
+	// 标题, 用于查询时
+	"title": "${title || 'static资源'}",
+	// 状态 0未启用，1启用
+	"state": 1,
 	// 资源缓存寿命，单位：秒
-	"maxAge": 0,
+	"max_age": 0,
 	// 是否恒久不变，一般资源文件可能变化，所以这里一般是false
 	"immutable": false,
 	// 是否使用brotli压缩方式
@@ -15,6 +19,6 @@
 	"extensions": null,
 	// 是否转换JS、vue代码为amd标准，true的情况下会把es6和commonJS都转成amd格式
 	"convert_amd": false,
-	// 调用脚本文件，如果请求改路由情况会调用改脚本文件
-	"func_file": "./static.js"
+	// 调用脚本文件，如果请求改路由情况会调用改脚本文件 ./static.js
+	"main": ""
 }

package/com/static/drive.js

@@ -0,0 +1,194 @@
+const send = require('koa-send');
+const Item = require('mm_machine').Drive;
+const { Static } = require('mm_statics');
+
+/**
+ * 静态文件驱动类
+ * @augments {Item}
+ * @class 
+ */
+class Drive extends Item {
+  static config = {
+    // 应用名
+    'app': 'server',
+    // 插件名
+    'plugin': 'sys',
+    // 物理根目录
+    'root': '',
+    // 路由根路径
+    'path': '',
+    // 名称
+    'name': '',
+    // 首页
+    'index': 'index.html',
+    // 重定向
+    'redirect': true,
+    // 缓存保留10分钟
+    'max_age': 60 * 10,
+    // 是否保持不变
+    'immutable': true,
+    // 是否启用brotli压缩
+    'brotli': true,
+    // 是否启用gizp压缩
+    'gzip': true,
+    // 允许访问的拓展名
+    'extensions': null,
+    // 是否将ES6转换AMD
+    'convert_amd': true,
+    // 主程序文件 - 默认为空
+    'main': ''
+  };
+  /**
+   * 构造函数
+   * @param {object} config 配置参数
+   * @param {object} parent 父对象
+   * @class
+   */
+  constructor(config, parent) {
+    super({ ...Drive.config, ...config }, parent);
+    // 更新并重载
+    this.mode = 3;
+  }
+}
+
+/**
+ * 发送文件函数
+ */
+Drive.prototype.send = send;
+
+/**
+ * 更新配置对象前
+ */
+Drive.prototype._preset = function () {
+  var cg = this.config;
+  if (cg.maxAge) {
+    cg.max_age = cg.maxAge * 1000;
+    delete cg.maxAge;
+  }
+  if (!cg.app) {
+    cg.app = this.getAppName(this.config_file);
+  }
+  if (!cg.plugin) {
+    cg.plugin = this.getPluginName(this.config_file);
+  }
+  if (!cg.path) {
+    let app = cg.app || this.getAppName(this.config_file);
+    let plugin = cg.plugin || this.getPluginName(this.config_file);
+    if (plugin) {
+      cg.path = `/${app}/${plugin}/`;
+    }
+    else {
+      cg.path = `/${app}/`;
+    }
+  }
+  else if (!cg.path.endsWith('/')) {
+    cg.path += '/';
+  }
+  if (!cg.root) {
+    cg.root = this._getRoot(this.config_file);
+  }
+  this.static = new Static(cg);
+};
+
+/**
+ * 获取应用名
+ * @param {string} file 文件路径
+ * @returns {string} 应用名
+ */
+Drive.prototype.getAppName = function (file) {
+  if (!file || typeof file !== 'string') {
+    return '';
+  }
+  return file.between('app/', '/') || '';
+};
+
+/**
+ * 获取插件名
+ * @param {string} file 文件路径
+ * @returns {string} 插件名
+ */
+Drive.prototype.getPluginName = function (file) {
+  if (!file || typeof file !== 'string') {
+    return '';
+  }
+  return file.between('plugin/', '/') || '';
+};
+
+/**
+ * 获取物理根目录
+ * @param {string} file 文件路径
+ * @returns {string} 物理根目录
+ */
+Drive.prototype._getRoot = function (file) {
+  if (!file || typeof file !== 'string') {
+    return '';
+  }
+  let f = file.replace(/\\/g, '/');
+  let dir = f.dirname().replace(/\\/g, '/').toLowerCase();
+  let ph = $.run_path.replace(/\\/g, '/').toLowerCase();
+  return dir.replace(ph, '.');
+};
+
+/**
+ * 执行前
+ * @param {object} ctx http请求上下文
+ * @param {object} path 文件路径
+ */
+Drive.prototype.before = async function (ctx, path) { };
+
+/**
+ * 执行
+ * @param {object} ctx http请求上下文
+ * @param {object} path 文件路径
+ * @returns {boolean} 成功发送返回true，失败返回false
+ */
+Drive.prototype.main = async function (ctx, path) {
+  return send(ctx, path, this.config);
+};
+
+/**
+ * 执行后
+ * @param {object} ctx http请求上下文
+ * @param {object} path 文件路径
+ */
+Drive.prototype.after = async function (ctx, path) { };
+
+/**
+ * 执行静态文件
+ * @param {object} ctx Http请求上下文
+ * @param {object} next 跳过当前函数
+ * @returns {string} 执行成功返回文件路径
+ */
+Drive.prototype.run = async function (ctx, next) {
+  return await this.static.main(ctx, next);
+};
+
+/**
+ * 获取名称
+ * @param {string} file 文件路径
+ * @returns {string} 名称
+ */
+Drive.prototype._getName = function (file) {
+  return file.dirname().dirname().basename();
+};
+
+/**
+ * 获取模型
+ * @param {string} type 模型类型
+ * @returns {object} 返回获取到的模型
+ */
+Drive.prototype.getModel = function (type) {
+  let model = { ...this.config };
+  let dir = this._getDir();
+  let l = $.slash;
+  let app_name = dir.between('app' + l, l);
+  let plugin_name = dir.between('plugin' + l, l);
+  let name = dir.basename();
+  model.app = app_name;
+  model.plugin = plugin_name;
+  model.name = model.name || plugin_name ? plugin_name + '_' + name : app_name + '_' + name;
+  model.path = model.path || plugin_name ? `/${app_name}/${plugin_name}/` : `/${app_name}/`;
+  return model;
+};
+
+module.exports = Drive;

package/com/static/index.js

@@ -0,0 +1,226 @@
+const Manager = require('mm_machine').Manager;
+const Drive = require('./drive');
+
+/**
+ * 静态文件管理类
+ * @augments {Manager}
+ * @class
+ */
+class Static extends Manager {
+  /**
+     * 配置参数
+     * @type {object}
+     */
+  static config = {
+    /**
+     * 名称
+     * @type {string}
+     */
+    name: '',
+    /**
+     * 标题
+     * @type {string}
+     */
+    title: '静态文件管理',
+    /**
+     * 描述
+     * @type {string}
+     */
+    description: '这是静态文件管理器',
+    /**
+     * 检索文件名
+     * @type {string}
+     */
+    filename: 'static.json',
+    /**
+     * 模板目录
+     * @type {string}
+     */
+    tpl_dir: __dirname,
+    /**
+     * 基础目录
+     * @type {string}
+     */
+    base_dir: '../common/static'.fullname(__dirname),
+    /**
+     * 自定义目录，加载项目自定义资源
+     * @type {string}
+     */
+    dir: './app'.fullname(),
+    /**
+     * 搜索模式 dir按目录搜索 | file按文件名搜索
+     * @type {string}
+     */
+    search_way: 'file',
+    /**
+     * 是否懒加载
+     * @type {boolean}
+     */
+    lazy_load: false,
+    /**
+     * 模式
+     * 1.生产模式，改变文件不会重新加载
+     * 2.热更新模式，改变配置文件会重新加载配置，不重新加载脚本
+     * 3.热重载模式，改变配置文件都会加载配置和脚本
+     * 4.重载模式，执行完后重新加载脚本，避免变量污染
+     * 5.热更新+重载模式，改变配置文件重新加载配置和脚本，执行完后重新加载脚本
+     * @type {number}
+     */
+    mode: 3
+  };
+
+  /**
+   * 构造函数
+   * @param {object} config 配置参数
+   * @param {object} parent 父级模块
+   */
+  constructor(config, parent) {
+    super({ ...Static.config, ...config }, parent);
+  }
+
+  /**
+   * 处理请求
+   * @param {object} ctx Http请求上下文
+   * @param {object} next 跳过函数
+   */
+  async _handleRequest(ctx, next) {
+    var md = ctx.method;
+    var path = ctx.path;
+    if (md === 'GET' || md === 'HEAD') {
+      await this._handleGetRequest(ctx, next, path);
+    } else {
+      await next();
+    }
+  }
+
+  /**
+   * 处理GET请求
+   * @param {object} ctx Http请求上下文
+   * @param {object} next 跳过函数
+   */
+  async run(ctx, next) {
+    var done;
+    var infos = this.getInfos();
+    var len = infos.length;
+    let path = ctx.path;
+    if (path.indexOf('.') !== -1) {
+      done = await this._tryServeFile(ctx, infos, len, function () { });
+      if (!done) {
+        await next();
+      }
+    } else {
+      await next();
+      await this._handleDirReq(ctx, infos, len, path);
+    }
+  }
+
+  /**
+   * 尝试提供文件服务
+   * @param {object} ctx Http请求上下文
+   * @param {Array} list 驱动列表
+   * @param {number} len 列表长度
+   * @param {object} next 跳过函数
+   * @returns {boolean} 是否成功
+   */
+  async _tryServeFile(ctx, infos, len, next) {
+    for (var i = 0; i < len; i++) {
+      var info = infos[i];
+      if (info.state === 1) {
+        let mod = this.getMod(info.name);
+        if (mod) {
+          var done = await mod.run(ctx, next);
+          if (done) {
+            return true;
+          }
+        }
+      }
+    }
+    return false;
+  }
+
+  /**
+   * 处理目录请求
+   * @param {object} ctx Http请求上下文
+   * @param {Array} infos 驱动信息列表
+   * @param {number} len 列表长度
+   * @param {string} path 请求路径
+   */
+  async _handleDirReq(ctx, infos, len, path) {
+    var q = ctx.request.querystring;
+    for (var i = 0; i < len; i++) {
+      var info = infos[i];
+      if (info.state === 1) {
+        let mod = this.getMod(info.name);
+        if (mod) {
+          var p = mod.config.path;
+          if (path === p) {
+            this._handleExactMatch(ctx, q, p);
+            break;
+          } else {
+            var done = await mod.run(ctx, () => { });
+            if (done) {
+              break;
+            }
+          }
+        }
+      }
+    }
+  }
+
+  /**
+   * 处理精确匹配
+   * @param {object} ctx Http请求上下文
+   * @param {string} q 查询字符串
+   * @param {string} p 路径
+   */
+  _handleExactMatch(ctx, q, p) {
+    if (ctx.status === 404) {
+      if (q) {
+        ctx.redirect(p + '/?' + q);
+      } else {
+        ctx.redirect(p + '/');
+      }
+    }
+  }
+}
+
+/**
+ * 静态文件驱动类
+ * @type {Drive}
+ */
+Static.prototype.Drive = Drive;
+
+exports.Static = Static;
+
+/**
+ * 创建全局管理器
+ */
+if (!$.pool.static) {
+  $.pool.static = {};
+}
+
+/**
+ * 静态文件管理器
+ * @param {string} scope 作用域
+ * @param {string} title 标题
+ * @returns {object} 返回一个缓存类
+ */
+function staticAdmin(scope, title) {
+  var sc = scope || $.val.scope + '';
+  var obj = $.pool.static[sc];
+  if (!obj) {
+    $.pool.static[sc] = new Static({
+      name: sc,
+      title: title
+    });
+    obj = $.pool.static[sc];
+  }
+  return obj;
+}
+
+/**
+ * @module 导出Static管理器
+ */
+if ($.admin) {
+  $.admin.static = staticAdmin;
+}

package/com/static/script.tpl.js

@@ -0,0 +1,28 @@
+/**
+ * 执行前
+ * @param {object} ctx http请求上下文
+ * @param {object} path 文件路径
+ */
+async function before(ctx, path) {};
+
+/**
+ * 执行
+ * @param {object} ctx http请求上下文
+ * @param {object} path 文件路径
+ * @returns {boolean} 成功发送返回true，失败返回false
+ */
+async function main(ctx, path) {
+  return this.send(ctx, path, this.config);
+};
+
+/**
+ * 执行后
+ * @param {object} ctx http请求上下文
+ * @param {object} path 文件路径
+ */
+async function after(ctx, path) {};
+
+
+exports.before = before;
+exports.main = main;
+exports.after = after;

package/com/task/com.json

@@ -0,0 +1,5 @@
+{
+    "name": "Task",
+    "title": "定时任务管理器",
+    "state": 1
+}

package/{core/com → com}/task/config.tpl.json

@@ -1,14 +1,12 @@
 {
+	// 任务名称，用于动态增删改查
+	"name": "${name || 'demo'}",
 	// 任务标题
-	"title": "示例任务",
+	"title": "${title || '任务'}",
 	// 任务描述
-	"description": "描述任务使用方法",
-	// 任务名称，用于动态增删改查
-	"name": "demo",
+	"description": "${description || '描述任务使用方法'}",
 	// 状态 0未启用，1启用
 	"state": 1,
-	// 任务驱动的脚本文件
-	"func_file": "./index.js",
 	// 任务执行次数，执行次数达标后不再执行。0为不限次数，一直执行
 	"num": 2,
 	// 任务间隔时长，单位：毫秒