mm_container 1.0.2 → 1.1.0

package/README.md

@@ -5,7 +5,7 @@
 ## 项目信息
 
 - **当前版本**: 1.0.0
-- **依赖**: mm_corejs（Admin 实例管理）
+- **依赖**: mm_admin（Admin 实例管理与全局注册表）
 - **运行环境**: Node.js（使用私有字段 `#map`，需 Node.js 12+）
 - **Gitee地址**: https://gitee.com/qiuwenwu91/mm_container
 
@@ -83,7 +83,7 @@ console.log(cache_container === os_container); // false
 | 导出 | 签名 | 返回值 | 说明 |
 | --- | --- | --- | --- |
 | Container | `Container` | `Class` | 容器类，见下文 |
-| admin | `admin` | `Admin` | mm_corejs 的实例管理器，已绑定 `Container` |
+| admin | `admin` | `Admin` | mm_admin 全局注册表中名为 `mm_container` 的实例管理器，已绑定 `Container` |
 | containerAdmin | `containerAdmin(scope?, config?)` | `Container` | 获取指定作用域的容器实例，`scope` 为空时使用默认作用域 `'os'`。实例按作用域缓存，**配置仅在首次创建时生效**，`config.name` 始终等于作用域名 |
 
 > 需要跨模块共享同一个容器时，统一使用 `containerAdmin('作用域名')`，避免各自 `new Container()` 造成数据不互通。

package/index.js

@@ -1,9 +1,9 @@
 'use strict';
 
 const Container = require('./lib/container');
-const { Admin } = require('mm_corejs');
+const { reg } = require('mm_admin');
 
-const admin = new Admin();
+const admin = reg('mm_container');
 admin.setClass(Container);
 
 /**
@@ -14,10 +14,7 @@ admin.setClass(Container);
  * @returns {Container} 容器实例
  */
 function containerAdmin(scope, config) {
-  if (!scope) {
-    scope = 'os';
-  }
-  return admin.get(scope, config);
+  return admin.get(scope || 'os', config);
 }
 
 module.exports = {
@@ -25,3 +22,7 @@ module.exports = {
   admin,
   containerAdmin
 };
+
+/* mm-tool-logic-export 工具能力层：其它模块可 require("<pkg>").tools.<name> 直接引用 */
+Object.defineProperty(module.exports, 'tools', { enumerable: true, configurable: true,
+  get: function () { return require('./lib/tools'); } });

package/lib/tools/container/index.js

@@ -0,0 +1,82 @@
+/**
+ * 内存容器管理器
+ * 基于 containerAdmin 作用域单例存取对象值，进程内存活、不落盘
+ * @param {object} params 步骤参数
+ * @param {object} ctx 上下文对象
+ * @returns {object} 操作结果
+ */
+const { containerAdmin } = require('../../../index.js');
+
+async function main(params, ctx, options) {
+  void options;
+  var action = params.action || 'get';
+
+  try {
+    var container = containerAdmin(params.scope || 'os');
+
+    switch (action) {
+      case 'set': {
+        _assertKey(params.key);
+        container.set(params.key, params.value);
+        ctx.output = { key: params.key, msg: '设置成功' };
+        break;
+      }
+
+      case 'get': {
+        _assertKey(params.key);
+        ctx.output = {
+          key: params.key,
+          value: container.get(params.key),
+          exists: container.has(params.key)
+        };
+        break;
+      }
+
+      case 'has': {
+        _assertKey(params.key);
+        ctx.output = { key: params.key, exists: container.has(params.key) };
+        break;
+      }
+
+      case 'del': {
+        _assertKey(params.key);
+        var deleted = container.del(params.key);
+        ctx.output = { key: params.key, deleted: deleted, msg: deleted ? '删除成功' : '键不存在' };
+        break;
+      }
+
+      case 'list':
+        ctx.output = { list: container.list(), size: container.size };
+        break;
+
+      case 'clear':
+        container.clear();
+        ctx.output = { msg: '清空成功' };
+        break;
+
+      default:
+        ctx.output = {
+          error: { code: 'MGR_UNKNOWN_ACTION', message: '不支持的操作: ' + action }
+        };
+    }
+  } catch (e) {
+    ctx.output = {
+      error: { code: 'CONTAINER_ERROR', message: e.message }
+    };
+  }
+
+  return ctx.output;
+}
+
+/**
+ * 校验键名
+ * @param {string} key 键名
+ * @returns {void}
+ */
+function _assertKey(key) {
+  if (typeof key !== 'string' || key.length === 0) {
+    throw new TypeError('缺少 key 键名参数');
+  }
+}
+
+module.exports = { main };

package/lib/tools/index.js

@@ -0,0 +1,16 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+/** 模块能力层：懒加载工具实现，避免模块入口被 require 时加载全部实现 */
+module.exports = new Proxy({}, {
+  get(_t, key) {
+    if (typeof key !== 'string') return undefined;
+    if (!fs.existsSync(path.join(__dirname, key, 'index.js'))) return undefined;
+    return require('./' + key);
+  },
+  has(_t, key) {
+    return typeof key === 'string' && fs.existsSync(path.join(__dirname, key, 'index.js'));
+  },
+  ownKeys() { return fs.readdirSync(__dirname, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name); },
+  getOwnPropertyDescriptor(_t, key) { return this.has(_t, key) ? { enumerable: true, configurable: true } : undefined; }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mm_container",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "容器工具，基于 Map 提供语义化的键值存取（set/get/has/del/clear/list），并保存容器配置与服务器实例。",
   "keywords": [
     "mm_mod",
@@ -11,14 +11,15 @@
     "键值存储",
     "container"
   ],
-  "layer": "infra",
-  "group": "common",
+  "layer": "shared",
+  "group": "kernel",
   "author": "邱文武",
   "license": "ISC",
   "main": "index.js",
   "files": [
     "index.js",
     "lib",
+    "tool",
     "example"
   ],
   "directories": {
@@ -31,7 +32,7 @@
     "prepublishOnly": "npm test"
   },
   "dependencies": {
-    "mm_corejs": "^1.1.5"
+    "mm_admin": "^1.1.0"
   },
   "devDependencies": {
     "jest": "^30.5.2"

package/tool/container/index.js

@@ -0,0 +1,7 @@
+'use strict';
+/**
+ * container —— 工具契约适配层
+ * 业务实现归位于模块 lib/tools/container/，本文件只把模块能力暴露给加载器。
+ * 其它模块可直接 require('mm_container').tools.container 复用。
+ */
+module.exports = require('../../lib/tools/container');

package/tool/container/tool.json

@@ -0,0 +1,81 @@
+{
+  "name": "container",
+  "handler": "manager",
+  "title": "内存容器管理器",
+  "description": "按作用域共享的内存键值容器，仅存储对象值，进程内存活、不落盘。适用场景：工作流步骤间传递对象引用、缓存临时句柄。工作流提示：action 选 set/get/has/del/list/clear，key 指定键名，set 需传 value 对象（不能是字符串/数字等基础值），结果 get 在 value 与 exists，list 在 list 与 size。",
+  "type": "data",
+  "params": {
+    "type": "object",
+    "properties": {
+      "action": {
+        "type": "string",
+        "description": "操作类型: set(写入)/get(读取)/has(判断存在)/del(删除)/list(列出全部值)/clear(清空)",
+        "enum": [
+          "set",
+          "get",
+          "has",
+          "del",
+          "list",
+          "clear"
+        ],
+        "default": "get"
+      },
+      "scope": {
+        "type": "string",
+        "description": "容器实例作用域，同作用域共享同一容器，缺省 os",
+        "default": "os"
+      },
+      "key": {
+        "type": "string",
+        "description": "键名(set/get/has/del时必填)"
+      },
+      "value": {
+        "type": "object",
+        "description": "键值对象(set时必填，只能是对象，不能是基础值或函数)"
+      }
+    },
+    "required": [
+      "action"
+    ]
+  },
+  "returns": {
+    "description": "get 返回 value 与 exists，has 返回 exists，del 返回 deleted，list 返回 list 与 size，set/clear 返回 msg",
+    "type": "object",
+    "properties": {
+      "key": {
+        "type": "string",
+        "description": "键名"
+      },
+      "value": {
+        "type": "object",
+        "description": "读取到的对象(get操作)"
+      },
+      "exists": {
+        "type": "boolean",
+        "description": "键是否存在(get/has操作)"
+      },
+      "deleted": {
+        "type": "boolean",
+        "description": "是否删除成功(del操作)"
+      },
+      "list": {
+        "type": "array",
+        "description": "全部值数组(list操作)"
+      },
+      "size": {
+        "type": "number",
+        "description": "键值数量(list操作)"
+      },
+      "msg": {
+        "type": "string",
+        "description": "写操作结果描述(set/clear操作)"
+      },
+      "error": {
+        "type": "object",
+        "description": "错误对象 { code, message }"
+      }
+    }
+  },
+  "options": {},
+  "group": "system"
+}