mm_machine 5.0.0 → 6.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -2
- package/lib/manager.js +36 -18
- package/package.json +6 -4
package/README.md
CHANGED
|
@@ -498,9 +498,9 @@ mm_machine 模块系统基于以下核心设计理念:
|
|
|
498
498
|
|
|
499
499
|
`update(dir)` 完成后会对检索目录开启一次递归监听(经 mm_loader 的 `Loader.watch`,配置文件与 `.js` 脚本的变更按扩展名分流):
|
|
500
500
|
|
|
501
|
-
- 所有管理器默认共享 mm_loader 的同一个加载器实例(`loadAdmin(config.
|
|
501
|
+
- 所有管理器默认共享 mm_loader 的同一个加载器实例(`loadAdmin(config.load_scope || 'app')`),避免重复扫描、重复监听与重复加载
|
|
502
502
|
- 管理器把自己的清单文件名登记为加载器类型:类型键为文件名去掉 `.json` 后缀(`manager.json` → `manager`),已存在的类型不覆盖
|
|
503
|
-
- 需要独立加载器时,用 `
|
|
503
|
+
- 需要独立加载器时,用 `load_scope` 指定另一加载器名(一个名称对应一个目录,实例即 `Loader.<load_scope>`)
|
|
504
504
|
|
|
505
505
|
| 变更 | 模式要求 | 行为 |
|
|
506
506
|
| --- | --- | --- |
|
|
@@ -576,6 +576,18 @@ mm_machine 模块系统基于以下核心设计理念:
|
|
|
576
576
|
|
|
577
577
|
## 更新日志
|
|
578
578
|
|
|
579
|
+
### 6.0.0
|
|
580
|
+
|
|
581
|
+
- 加载器实例键改为 `load_scope`(即 `Loader.name`),不再拼接 `@目录`:同一应用目录共用一个加载器,其他目录请配置不同的 `load_scope`(如 `data`)。
|
|
582
|
+
- `_findFiles` 改为「扫描一次 + 按类型取切片」:先 `loader.ensureScanned()`,再从 `typeStore(type)` 读取加载器扫描根下的条目,按文件名与目标子目录过滤,多个管理器不再各自扫描。
|
|
583
|
+
- 依赖升级:`mm_loader ^7.0.0`、新增 `mm_scanner ^5.0.0` 与 `mm_store ^1.0.1`。
|
|
584
|
+
- 移除未使用的 `use_scope` 配置,加载器实例共享统一由 `load_scope` 控制。
|
|
585
|
+
|
|
586
|
+
### 5.0.1
|
|
587
|
+
|
|
588
|
+
- 配置加载依赖升级到 `mm_loader@^4.0.1`:该版本修复了 `load()` 在 JSON5 解析之外额外对整串 `{表达式}` 做模板字段求值的 BUG,现在 `load()` 只委托 `mm_helper.loadJson` 把配置读成对象,花括号内容一律原样保留。
|
|
589
|
+
- 本模块源码无需改动:`_readModConfig` 本就通过 `_getLoader().load()` 加载配置,**配置加载职责保持在 mm_machine 这一层**。子类(如 `mm_mcps`)不必覆盖 `_readModConfig`,也不必直接依赖 `mm_loader`;运行时内变量由各业务模块在消费配置时自行解析。
|
|
590
|
+
|
|
579
591
|
### v4.1.0
|
|
580
592
|
|
|
581
593
|
- 配置加载器改为共享:`_getLoader()` 默认取 mm_loader 实例池中的同一个 `Loader`(`loadAdmin(config.use_scope || 'os')`),不再为每个管理器各建实例
|
package/lib/manager.js
CHANGED
|
@@ -2,6 +2,7 @@ const path = require('path');
|
|
|
2
2
|
const { Manager: Core } = require('mm_mod');
|
|
3
3
|
const { hasDir, hasFile, fullname, basename, dirname, string } = require('mm_helper');
|
|
4
4
|
const { loadAdmin } = require('mm_loader');
|
|
5
|
+
const { typeStore } = require('mm_scanner');
|
|
5
6
|
const { Mod, addMethods } = require('./mod.js');
|
|
6
7
|
const { Drive, MODE } = require('./drive.js');
|
|
7
8
|
const { resolveScriptFile, reloadScript } = require('./script_protocol.js');
|
|
@@ -16,6 +17,19 @@ function _normPath(file) {
|
|
|
16
17
|
return path.resolve(String(file)).toLowerCase();
|
|
17
18
|
}
|
|
18
19
|
|
|
20
|
+
/**
|
|
21
|
+
* 判断文件是否位于指定目录内(含子目录)
|
|
22
|
+
* @description 加载器按应用根目录扫描,管理器只处理自己目录范围内的清单
|
|
23
|
+
* @param {string} file 文件路径
|
|
24
|
+
* @param {string} dir 目录绝对路径
|
|
25
|
+
* @returns {boolean} 位于目录内返回 true
|
|
26
|
+
* @private
|
|
27
|
+
*/
|
|
28
|
+
function _inDir(file, dir) {
|
|
29
|
+
const rel = path.relative(dir, file);
|
|
30
|
+
return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
|
|
31
|
+
}
|
|
32
|
+
|
|
19
33
|
/**
|
|
20
34
|
* 失效单个脚本文件的 require 缓存
|
|
21
35
|
* @description 文件不存在或从未加载时静默跳过
|
|
@@ -107,10 +121,10 @@ class Manager extends Core {
|
|
|
107
121
|
*/
|
|
108
122
|
scope: 'server',
|
|
109
123
|
/**
|
|
110
|
-
*
|
|
124
|
+
* 共享加载器作用域,取用 loadAdmin 实例时使用,缺省 'app'
|
|
111
125
|
* @type {string}
|
|
112
126
|
*/
|
|
113
|
-
|
|
127
|
+
load_scope: 'app',
|
|
114
128
|
/**
|
|
115
129
|
* 忽略目录数组
|
|
116
130
|
* @type {Array}
|
|
@@ -223,27 +237,27 @@ Manager.prototype.getTplDir = function () {
|
|
|
223
237
|
|
|
224
238
|
/**
|
|
225
239
|
* 获取配置加载器
|
|
226
|
-
* @description 直接取 mm_loader 实例池中的共享 Loader(键为
|
|
227
|
-
*
|
|
228
|
-
*
|
|
229
|
-
*
|
|
240
|
+
* @description 直接取 mm_loader 实例池中的共享 Loader(键为 load_scope,缺省 'app'),
|
|
241
|
+
* 同一加载器名天然是同一个实例,本管理器不再另存一份引用;
|
|
242
|
+
* 一个加载器只负责一个目录,多目录请为每个目录配置不同的 load_scope;
|
|
243
|
+
* load_scope 即加载器实例键(Loader.name),与内核创建的实例同名即共享。
|
|
230
244
|
* 并把本管理器清单类型登记进该实例:类型键为 filename 去掉 .json 后缀
|
|
231
245
|
* (manager.json → manager,与默认 app → app.json 同构),已存在的类型不覆盖;
|
|
232
246
|
* 脚本监听由 _watchDir 是否传 script_callback 决定(回调驱动),不再配置实例
|
|
233
|
-
* @param {string} [dir]
|
|
247
|
+
* @param {string} [dir] 检索目录,用于首次创建实例时确定扫描根目录,缺省回退 config.dir
|
|
234
248
|
* @returns {Loader} 配置加载器
|
|
235
249
|
* @private
|
|
236
250
|
*/
|
|
237
251
|
Manager.prototype._getLoader = function (dir) {
|
|
238
|
-
const scope = this.config.
|
|
252
|
+
const scope = this.config.load_scope || 'app';
|
|
239
253
|
const target = dir || this.config.dir || '';
|
|
240
254
|
const key = target ? path.resolve(target) : '';
|
|
241
|
-
const loader = loadAdmin(scope, { dir: key
|
|
255
|
+
const loader = loadAdmin(scope, key ? { dir: key } : {});
|
|
242
256
|
const filename = this.config.filename;
|
|
243
257
|
if (filename) {
|
|
244
258
|
const type = filename.replace(/\.json$/i, '');
|
|
245
259
|
if (type && !loader.config.resources[type]) {
|
|
246
|
-
loader.addType(type, filename
|
|
260
|
+
loader.addType(type, filename);
|
|
247
261
|
}
|
|
248
262
|
}
|
|
249
263
|
return loader;
|
|
@@ -338,7 +352,6 @@ Manager.prototype._readModConfig = function (config_file, config = {}) {
|
|
|
338
352
|
}
|
|
339
353
|
// 归属信息:app 为所属应用(声明值优先,兼作注册域),plugin 为所属插件(应用级资源为空),
|
|
340
354
|
// scope 为注册域(与管理器域一致的推导口径,即该资源配置到 require(module).admin 的哪个域)。
|
|
341
|
-
// 旧版 update(dir) 全量扫描注册(如 xxx_web 网关镜像)不经过 load_resources/_addResource,
|
|
342
355
|
// 归属信息统一在这里兜底注入
|
|
343
356
|
if (config_file) {
|
|
344
357
|
const norm_path = String(config_file).replace(/\\/g, '/');
|
|
@@ -566,6 +579,8 @@ Manager.prototype.update = async function (dir, clear = true) {
|
|
|
566
579
|
|
|
567
580
|
/**
|
|
568
581
|
* 检索目录下所有文件
|
|
582
|
+
* @description 扫描只做一次:加载器已扫描时直接复用类型 Store 中的分类结果,
|
|
583
|
+
* 再按管理器的清单文件名精确过滤,不再重复遍历目录
|
|
569
584
|
* @private
|
|
570
585
|
* @param {string} dir 目录路径
|
|
571
586
|
* @returns {Array} 文件路径数组
|
|
@@ -578,14 +593,17 @@ Manager.prototype._findFiles = async function (dir) {
|
|
|
578
593
|
if (!hasDir(dir)) {
|
|
579
594
|
return [];
|
|
580
595
|
}
|
|
581
|
-
|
|
582
|
-
// update 语义要求看到新增/删除的文件
|
|
583
|
-
let files = this._getLoader(dir).scan();
|
|
596
|
+
let loader = this._getLoader(dir).ensureScanned();
|
|
584
597
|
let filename = this.config.filename;
|
|
585
598
|
if (!filename) {
|
|
586
|
-
return files;
|
|
599
|
+
return loader.files;
|
|
587
600
|
}
|
|
588
|
-
|
|
601
|
+
let type = filename.replace(/\.json$/i, '');
|
|
602
|
+
let scope = path.resolve(dir);
|
|
603
|
+
return typeStore(type)
|
|
604
|
+
.list({ root: loader.config.dir })
|
|
605
|
+
.filter((one) => one.name === filename && _inDir(one.file, scope))
|
|
606
|
+
.map((one) => one.file);
|
|
589
607
|
};
|
|
590
608
|
|
|
591
609
|
// ==== 目录监听 ====
|
|
@@ -604,11 +622,11 @@ Manager.prototype._watchDir = function (dir) {
|
|
|
604
622
|
let hot = this._isScriptHot();
|
|
605
623
|
let loader = this._getLoader(dir);
|
|
606
624
|
let config_callback = (changes) => {
|
|
607
|
-
this._applyChanges(changes);
|
|
625
|
+
this._applyChanges(changes.filter((one) => _inDir(one.file, dir)));
|
|
608
626
|
};
|
|
609
627
|
let script_callback = hot
|
|
610
628
|
? (changes) => {
|
|
611
|
-
this._applyScriptChanges(changes);
|
|
629
|
+
this._applyScriptChanges(changes.filter((one) => _inDir(one.file, dir)));
|
|
612
630
|
}
|
|
613
631
|
: undefined;
|
|
614
632
|
let success = loader.watch(config_callback, script_callback);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
|
|
3
|
-
|
|
2
|
+
"name": "mm_machine",
|
|
3
|
+
"version": "6.0.0",
|
|
4
4
|
"description": "A flexible Node.js plugin mechanism system for dynamic loading, management and execution of modules. Supports hot reload, lifecycle management, and modern JavaScript features.",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"scripts": {
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
"framework",
|
|
26
26
|
"mechanism"
|
|
27
27
|
],
|
|
28
|
-
"layer": "
|
|
28
|
+
"layer": "infrastructure",
|
|
29
29
|
"group": "runtime",
|
|
30
30
|
"author": "邱文武",
|
|
31
31
|
"license": "ISC",
|
|
@@ -42,8 +42,10 @@
|
|
|
42
42
|
"@prettier/sync": "^0.6.1",
|
|
43
43
|
"mm_config": "^2.5.3",
|
|
44
44
|
"mm_helper": "^1.0.3",
|
|
45
|
-
"mm_loader": "^
|
|
45
|
+
"mm_loader": "^7.0.0",
|
|
46
46
|
"mm_mod": "^1.0.6",
|
|
47
|
+
"mm_scanner": "^5.0.0",
|
|
48
|
+
"mm_store": "^1.0.1",
|
|
47
49
|
"mm_tpl": "^2.7.3"
|
|
48
50
|
},
|
|
49
51
|
"devDependencies": {
|