mm_os 4.3.7 → 5.0.1

package/lib/os.js

@@ -0,0 +1,536 @@
+const path = require('path');
+const { Mod } = require('mm_mod');
+const { containerAdmin } = require('mm_container');
+const { getLogger } = require('mm_logger');
+const { Loader } = require('mm_loader');
+const { appAdmin } = require('mm_apps');
+const { eventAdmin } = require('mm_event');
+
+/**
+ * OS类
+ */
+class OS extends Mod {
+  static config = {
+    name: 'os',
+    in_adapters: [{
+      name: 'web',
+      module: 'mm_web_server'
+    }, {
+      name: 'mqtt',
+      module: 'mm_mqtt_server'
+    }, {
+      name: 'socket',
+      module: 'mm_socket_server'
+    }, {
+      name: 'websocket',
+      module: 'mm_websocket_server'
+    }],
+    // 输出适配器
+    out_adapters: [{
+      name: 'redis',
+      module: 'mm_redis'
+    }, {
+      name: 'mongodb',
+      module: 'mm_mongodb'
+    }, {
+      name: 'mysql',
+      module: 'mm_mysql'
+    }, {
+      name: 'sqlite',
+      module: 'mm_sqlite'
+    }, {
+      name: 'jsondb',
+      module: 'mm_jsondb'
+    }, {
+      name: 'file',
+      module: 'mm_files'
+    }],
+    tools: [{
+      name: 'lang',
+      module: 'mm_lang'
+    }, {
+      name: 'tpl',
+      module: 'mm_tpl'
+    }, {
+      name: 'ret',
+      module: 'mm_ret'
+    }],
+    admins: [{
+      name: 'event',
+      module: 'mm_event'
+    }, {
+      name: 'api',
+      module: 'mm_api'
+    }, {
+      name: 'param',
+      module: 'mm_param'
+    }, {
+      name: 'dao',
+      module: 'mm_dao'
+    }, {
+      name: 'service',
+      module: 'mm_service'
+    }, {
+      name: 'template',
+      module: 'mm_template'
+    }, {
+      name: 'pendant',
+      module: 'mm_pendant'
+    }, {
+      name: 'timer',
+      module: 'mm_timer'
+    }, {
+      name: 'static',
+      module: 'mm_statics'
+    }],
+    cache: {
+      type: 'redis'
+    },
+    sql: {
+      type: 'mysql'
+    },
+    web: {
+      port: 8000
+    },
+    mqtt: {
+      port: 1883
+    },
+    socket: {
+      port: 9000
+    },
+    websocket: {
+      port: 9001
+    },
+    jsondb: {
+      dir: './data'
+    },
+    mysql: {
+      host: '127.0.0.1',
+      port: 3306,
+      user: 'root',
+      password: 'Asd159357',
+      database: 'mm'
+    },
+    redis: {
+      host: '127.0.0.1',
+      password: 'asd159357',
+      port: 6379,
+      db: 0
+    },
+    mongodb: {
+      host: '127.0.0.1',
+      port: 27017,
+      user: 'root',
+      password: 'asd123',
+      database: 'mm'
+    },
+    sqlite: {
+      dir: './db',
+      database: 'mm',
+      user: 'root',
+      password: 'asd123'
+    },
+    ret: {
+      type: 'json-rpc'
+    },
+    lang: {
+      type: 'zh_cn'
+    },
+    tpl: {
+      dir: './static/template',
+      ext: '.html'
+    },
+    loader: {
+      dir: ''
+    }
+  }
+
+  /**
+   * OS类构造函数
+   * @param {object} config 配置对象
+   */
+  constructor(config) {
+    super(config);
+    /**
+     * 实例容器（按作用域共享）
+     * @type {object}
+     */
+    this.container = containerAdmin('os', { name: 'os' });
+    this.container.server = this;
+  }
+
+  /**
+   * 生命周期初始化钩子
+   * @returns {void} 无返回值
+   */
+  async onInit() {
+    this.initConfig();
+    this.initLogger();
+    // 初始化事件总线
+    this.initEventBus();
+    // 存储需先于管理器初始化：mm_dao 等管理器会通过 mm_sql 的 getSql() 复用同名 SQL 实例，
+    // 若管理器先创建，则会以默认（空库名）配置占用实例，导致后续 SQL 报 No database selected
+    await this.initpStorage();
+    await this.initAdmins();
+    await this.initAdapter();
+    await this.initLoader();
+  }
+}
+
+/**
+ * 初始化配置管理器
+ */
+OS.prototype.initConfig = function () {
+  const { admin } = require('mm_config');
+  admin.setServer(this);
+  admin.get('os', this.config);
+  admin.get('cache', { ...this.config.cache, redis: this.config.redis, mongodb: this.config.mongodb });
+  admin.get('sql', { ...this.config.sql, mysql: this.config.mysql, sqlite: this.config.sqlite, jsondb: this.config.jsondb });
+  admin.get('web', this.config.web);
+  admin.get('mqtt', this.config.mqtt);
+  admin.get('socket', this.config.socket);
+  admin.get('websocket', this.config.websocket);
+  admin.get('jsondb', this.config.jsondb);  
+  admin.get('redis', this.config.redis);
+  admin.get('mongodb', this.config.mongodb);
+  admin.get('sqlite', this.config.sqlite);
+  admin.get('mysql', this.config.mysql);
+  admin.get('ret', this.config.ret);
+  admin.get('lang', this.config.lang);
+  admin.get('tpl', this.config.tpl);
+  admin.get('loader', this.config.loader);
+  this.reg('config', admin);
+};
+
+/**
+ * 初始化日志记录器
+ */
+OS.prototype.initLogger = function () {
+  this.reg('logger', getLogger(this.config.log || { level: 'info' }));
+};
+
+/**
+ * 记录日志
+ * @param {string} type 日志类型
+ * @param {string} msg 日志消息
+ * @param {...*} args 日志参数
+ */
+OS.prototype.log = function (type, msg, ...args) {
+  this.container.get('logger')[type](msg, ...args);
+};
+
+/**
+ * 注册管理
+ * @param {string} name 管理名称
+ * @param {object} admin 管理对象
+ */
+OS.prototype.reg = function (name, admin) {
+  this.container.set(name, admin);
+};
+
+/**
+ * 加载模块
+ * @param {string} mod_name 模块名称
+ * @returns {object} 模块对象
+ */
+OS.prototype.require = function (mod_name) {
+  return require(mod_name);
+};
+
+/**
+ * 初始化适配器
+ * @returns {void} 无返回值
+ */
+OS.prototype.initAdapter = async function () {
+  // 入站适配器
+  let adapters = this.config.in_adapters || [];
+  for (let mod of adapters) {
+    try {
+      let admin = this.require(mod.module).admin;
+      admin.setServer(this);
+      let manager = admin.get('os', this.config[mod.name]);
+      if (typeof manager.init === 'function') {
+        await manager.init();
+      }
+      this.reg(mod.name, manager);
+    } catch (error) {
+      this.log('error', `初始化适配器 ${mod.name} 失败: ${error}`);
+    }
+  }
+
+  // 出站适配器
+  let out_adapters = this.config.out_adapters || [];
+  for (let mod of out_adapters) {
+    try {
+      let admin = this.require(mod.module).admin;
+      admin.setServer(this);
+      let manager = admin.get('os', this.config[mod.name]);
+      if (typeof manager.init === 'function') {
+        await manager.init();
+      }
+      this.reg(mod.name, manager);
+    } catch (error) {
+      this.log('error', `初始化适配器 ${mod.name} 失败: ${error}`);
+    }
+  }
+};
+
+/**
+ * 初始化工具
+ * @returns {void} 无返回值
+ */
+OS.prototype.initTools = async function () {
+  let tools = this.config.tools || [];
+  for (let mod of tools) {
+    try {
+      let admin = this.require(mod.module).admin;
+      admin.setServer(this);
+      let manager = admin.get('os', this.config[mod.name]);
+      if (typeof manager.init === 'function') {
+        await manager.init();
+      }
+      this.reg(mod.name, manager);
+    } catch (error) {
+      this.log('error', `初始化工具 ${mod.name} 失败: ${error}`);
+    }
+  }
+};
+
+/**
+ * 初始化管理
+ * @returns {void} 无返回值
+ */
+OS.prototype.initAdmins = async function () {
+  let admins = this.config.admins || [];
+  for (let mod of admins) {
+    try {
+      let admin = this.require(mod.module).admin;
+      admin.setServer(this);
+      let manager = admin.get('os', this.config[mod.name]);
+      if (typeof manager.init === 'function') {
+        await manager.init();
+      }
+      this.reg(mod.name, manager);
+    } catch (error) {
+      this.log('error', `初始化管理 ${mod.name} 失败: ${error}`);
+    }
+  }
+};
+
+/**
+ * 初始化存储
+ * @returns {void} 无返回值
+ */
+OS.prototype.initpStorage = async function () {
+  // 初始化缓存存储
+  let cacheAdmin = this.require('mm_cache').admin;
+  this._setAdminServer(cacheAdmin);
+  let cache = cacheAdmin.get('os', Object.assign({}, this.config.cache, { redis: this.config.redis, mongodb: this.config.mongodb, cachebase: this.config.cachebase }));
+  if (typeof cache.init === 'function') {
+    await cache.init();
+  }
+  this.reg('cache', cache);
+
+  // 初始化数据库
+  let sqlAdmin = this.require('mm_sql').admin;
+  this._setAdminServer(sqlAdmin);
+  let sql = sqlAdmin.get('os', Object.assign({}, this.config.sql, { mysql: this.config.mysql, sqlite: this.config.sqlite, jsondb: this.config.jsondb }));
+  if (typeof sql.init === 'function') {
+    await sql.init();
+  }
+  this.reg('sql', sql);
+};
+
+/**
+ * 设置管理器服务器：已设置时跳过，避免同一 Admin 实例重复绑定
+ * @param {object} admin 管理器工厂实例
+ */
+OS.prototype._setAdminServer = function (admin) {
+  if (!admin.getServer()) {
+    admin.setServer(this);
+  }
+};
+
+/**
+ * 初始化应用加载器（协调层：只创建加载器与应用管理器，装配逻辑在 mm_apps/mm_plugins）
+ * @returns {void} 无返回值
+ */
+OS.prototype.initLoader = async function () {
+  // 配置加载器：注入 socket/mqtt 类型，其余类型由 mm_loader 默认提供
+  const loader = new Loader(this.config.loader || {});
+  loader.addType('socket', 'socket.json');
+  loader.addType('mqtt', 'mqtt.json');
+  this.reg('loader', loader);
+
+  // 应用管理器：装配应用由 AppManager.load 负责，插件随 App.onInit 引入
+  const app = appAdmin('os');
+  app.setServer(this);
+  app.setLogger(this.container.get('logger'));
+  this.reg('app', app);
+
+  const dir = this.config.loader.dir || path.join(__dirname, '..', 'example', 'app');
+  await app.load(dir, loader);
+  await app.init();
+
+  // 注入 Web 请求路由
+  this._initWeb();
+};
+
+/**
+ * 初始化 Web 适配器：注入跨作用域事件路由
+ * @returns {void} 无返回值
+ */
+OS.prototype._initWeb = function () {
+  const web = this.container.get('web');
+  if (!web) return;
+  web.setEventManager(this._createEventRouter());
+};
+
+/**
+ * 创建跨作用域事件路由：Web 适配器只持有 web 作用域，需转发到各应用作用域
+ * @returns {object} 含 run 方法的事件管理器
+ */
+OS.prototype._createEventRouter = function () {
+  return {
+    run: (target, params, ctx, options) => this._routeRequest(target, params, ctx, options)
+  };
+};
+
+/**
+ * 路由请求：先尝试静态资源，未命中再按应用顺序执行事件
+ * @param {string} target 请求路径
+ * @param {object} params 请求参数
+ * @param {object} ctx 请求上下文
+ * @param {object} options 事件运行选项
+ * @returns {Promise<*>} 事件执行结果
+ */
+OS.prototype._routeRequest = async function (target, params, ctx, options = {}) {
+  const statics = this.container.get('static');
+  if (!statics || typeof statics.run !== 'function') {
+    return await this._runAppEvents(target, params, ctx, options);
+  }
+  let result;
+  await statics.run(ctx, async () => {
+    result = await this._runAppEvents(target, params, ctx, options);
+  });
+  return result;
+};
+
+/**
+ * 按应用排序依次执行事件：命中结果、响应已写出或发生错误时中止
+ * @param {string} target 请求路径
+ * @param {object} params 请求参数
+ * @param {object} ctx 请求上下文
+ * @param {object} options 事件运行选项
+ * @returns {Promise<*>} 事件执行结果
+ */
+OS.prototype._runAppEvents = async function (target, params, ctx, options = {}) {
+  const app = this.container.get('app');
+  if (!app || typeof app.list !== 'function') return undefined;
+
+  const apps = app.list().slice().sort((a, b) => this._getSort(a) - this._getSort(b));
+  for (const item of apps) {
+    if (this._isRequestHandled(ctx) || ctx.error) return undefined;
+    const name = item.config && item.config.name;
+    if (!name) continue;
+    const app_options = {};
+    const result = await eventAdmin(name).run(target, params, ctx, app_options);
+    if (app_options.error) {
+      ctx.error = ctx.error || app_options.error;
+      options.error = options.error || app_options.error;
+      return undefined;
+    }
+    if (result !== undefined && result !== null) return result;
+  }
+  return undefined;
+};
+
+/**
+ * 判断请求是否已处理完毕：事件或中间件已写出响应
+ * @param {object} ctx 请求上下文
+ * @returns {boolean} 响应是否已写出
+ */
+OS.prototype._isRequestHandled = function (ctx) {
+  if (!ctx) return false;
+  if (ctx.handled === true) return true;
+  const res = ctx.res;
+  return !!(res && (res.writableEnded || res.headersSent));
+};
+
+/**
+ * 获取应用执行顺序
+ * @param {object} app 应用驱动实例
+ * @returns {number} 排序值，缺省 100
+ */
+OS.prototype._getSort = function (app) {
+  const sort = app && app.config ? app.config.sort : undefined;
+  return typeof sort === 'number' ? sort : 100;
+};
+
+/**
+ * 初始化事件总线
+ * @returns {void} 无返回值
+ */
+OS.prototype.initEventBus = function () {
+  let admin = this.require('mm_eventer').admin;
+  admin.setServer(this);
+  this.reg('eventer', admin.get('os'));
+};
+
+/**
+ * 启动适配器：按配置中的入站、出站适配器名称从容器取出管理器并启动
+ * @returns {void} 无返回值
+ */
+OS.prototype._startAdapters = async function () {
+  let mods = this.config.in_adapters;
+  for (let mod of mods) {
+    let manager = this.container.get(mod.name);
+    if (!manager || typeof manager.start !== 'function') continue;
+    try {
+      await manager.start();
+      this._printAddress(mod.name, manager);
+    } catch (error) {
+      this.log('error', `启动适配器 ${mod.name} 失败: ${error}`);
+    }
+  }
+};
+
+/**
+ * 启动
+ * @returns {void} 无返回值
+ */
+OS.prototype.start = async function () {
+  // 启动适配器
+  await this._startAdapters();
+
+  // 启动缓存存储
+  await this.container.get('cache').start();
+  // 启动数据库
+  await this.container.get('sql').start();
+
+  // 启动应用
+  const app = this.container.get('app');
+  if (app) {
+    await app.start();
+  }
+};
+
+/**
+ * 打印适配器监听地址
+ * @param {string} name 适配器名称
+ * @param {object} manager 适配器管理器实例
+ */
+OS.prototype._printAddress = function (name, manager) {
+  let { host, port } = manager.config || {};
+  if (!host || host === '0.0.0.0' || host === '::') {
+    host = 'localhost';
+  }
+  let protocol = { web: 'http', websocket: 'ws', socket: 'tcp', mqtt: 'mqtt' }[name] || name;
+  let address = `${protocol}://${host}`;
+  if (port) {
+    address += `:${port}`;
+  }
+  this.log('info', `适配器 ${name} 已启动: ${address}`);
+};
+
+module.exports = OS;

package/package.json

@@ -1,84 +1,60 @@
-{
-	"name": "mm_os",
-	"description": "MM_OS服务端架构，用于快速构建应用程序，支持网站建设、小程序后台、AI应用、物联网(IOT/AIOT)、游戏服务端等多种场景。",
-	"version": "4.3.7",
-	"main": "index.js",
-	"keywords": [
-		"AI",
-		"GAME",
-		"IOT",
-		"AIOT",
-		"游戏",
-		"物联网",
-		"小程序",
-		"网站建设",
-		"服务端框架",
-		"NodeJS",
-		"WebSocket",
-		"MQTT",
-		"Socket",
-		"koa"
-	],
-	"scripts": {
-		"dev": "cross-env NODE_ENV=development nodemon ./example/demo.js",
-		"test": "cross-env NODE_ENV=test node ./example/demo.js",
-		"prod": "cross-env NODE_ENV=production node ./example/demo.js"
-	},
-	"author": "qww",
-	"license": "ISC",
-	"dependencies": {
-		"aedes": "^1.1.2",
-		"compressing": "^2.1.3",
-		"koa": "^3.2.1",
-		"koa-body": "^8.0.1",
-		"koa-compress": "^5.2.2",
-		"koa-send": "^5.0.1",
-		"koa-websocket": "^7.0.0",
-		"mm_ai": "^1.4.8",
-		"mm_cache": "^1.5.4",
-		"mm_check": "^1.5.4",
-		"mm_config": "^2.5.2",
-		"mm_excel": "^1.2.4",
-		"mm_expand": "^2.5.4",
-		"mm_https": "^1.7.1",
-		"mm_kernel": "^1.0.6",
-		"mm_logs": "^1.7.2",
-		"mm_machine": "^3.5.4",
-		"mm_matchs": "^1.1.10",
-		"mm_session": "^1.6.2",
-		"mm_sql": "^1.6.6",
-		"mm_statics": "^1.9.0",
-		"mm_tpl": "^2.7.1",
-		"mm_xml": "^1.2.0",
-		"mqtt": "^5.15.2",
-		"qrcode": "^1.5.4"
-	},
-	"devDependencies": {
-		"@types/jest": "^30.0.0",
-		"eslint-formatter-table": "^7.32.1",
-		"eslint-plugin-jsdoc": "^64.4.0",
-		"jest": "^30.5.1",
-		"mm_eslint": "^1.7.7"
-	},
-	"repository": {
-		"type": "git",
-		"url": "git+https://gitee.com/qiuwenwu91/mm_os.git"
-	},
-	"files": [
-		"index.js",
-		"os.js",
-		"server.js",
-		"com.js",
-		"README.md",
-		"README_EN.md",
-		"LICENSE",
-		"adapter/",
-		"com/",
-		"common/",
-		"core/",
-		"ulits/",
-		"tcp.js",
-		"software.js",
-		"ai.js"
-	]
-}
+{
+  "name": "mm_os",
+  "version": "5.0.1",
+  "description": "这是OS系统",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/qiuwenwu91/mm_os.git"
+  },
+  "license": "ISC",
+  "author": "qww",
+  "type": "commonjs",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "lib",
+    "README.md"
+  ],
+  "directories": {
+    "example": "example",
+    "lib": "lib"
+  },
+  "scripts": {
+    "test": "node test.js",
+    "demo": "node --preserve-symlinks example/demo.js",
+    "api:test": "node api_test.js"
+  },
+  "dependencies": {
+    "markdown": "^0.5.0",
+    "mm_apps": "^1.0.2",
+    "mm_cache": "^1.5.5",
+    "mm_container": "^1.0.1",
+    "mm_corejs": "^1.1.5",
+    "mm_dao": "^1.8.0",
+    "mm_es6_to_amd": "^1.5.9",
+    "mm_event": "^2.2.4",
+    "mm_files": "^1.0.0",
+    "mm_handle": "^1.0.0",
+    "mm_jsondb": "^1.0.0",
+    "mm_loader": "^1.1.0",
+    "mm_logger": "^1.0.0",
+    "mm_mod": "^1.0.2",
+    "mm_mongodb": "^2.0.3",
+    "mm_mqtt_server": "^2.0.0",
+    "mm_mysql": "^2.5.6",
+    "mm_param": "^1.1.3",
+    "mm_pendant": "^1.1.1",
+    "mm_plugins": "^1.0.2",
+    "mm_redis": "^2.1.7",
+    "mm_render": "^1.0.0",
+    "mm_socket_server": "^3.0.0",
+    "mm_sql": "^1.8.2",
+    "mm_sqlite": "^1.5.5",
+    "mm_statics": "^1.9.1",
+    "mm_template": "^1.2.1",
+    "mm_timer": "^1.4.4",
+    "mm_tpl": "^2.7.3",
+    "mm_web_server": "^2.0.1",
+    "mm_websocket_server": "^2.0.0"
+  }
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Admin
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.