mm_machine 2.0.1 → 2.0.3

package/item.js

@@ -1,13 +1,31 @@
+require('mm_logs');
 const util = require('util');
 const conf = require('mm_config');
 const Mod = require('mm_hot_reload');
-$.mod = new Mod();
-$.require = function(file, func) {
+
+
+// 初始化模块管理器
+$.mod = $.mod || new Mod();
+
+/**
+ * 增强require函数，支持热更新
+ * @param {String} file 文件路径
+ * @param {Function} func 回调函数
+ * @returns {Object} 加载的模块
+ */
+$.require = function (file, func) {
 	return $.mod.load(file, func);
-}
-$.loadJson = function(file, func) {
+};
+
+/**
+ * 增强JSON加载函数，支持热更新
+ * @param {String} file 文件路径
+ * @param {Function} func 回调函数
+ * @returns {Object} 解析的JSON对象
+ */
+$.loadJson = function (file, func) {
 	return $.mod.load(file, func);
-}
+};
 
 /**
  * 驱动基础类
@@ -29,47 +47,48 @@ class Item {
 		/**
 		 * 默认文件
 		 */
-		this.default_file = "./sys.json";
+		this.default_file = './sys.json';
 
 		// 当前文件
-		this.filename;
+		this.filename = null;
+
 		/* 通用项 */
 		/**
 		 * 配置参数
 		 */
 		this.config = {
 			/**
-			 * 名称, 由中英文和下“_”组成, 用于卸载接口 例如: demo
+			 * 名称, 由中英文和下"_"组成, 用于卸载接口 例如: demo
 			 */
-			"name": "",
+			name: '',
 			/**
 			 * 标题, 介绍作用
 			 */
-			"title": "",
+			title: '',
 			/**
 			 * 描述, 用于描述该有什么用的
 			 */
-			"description": "",
+			description: '',
 			/**
 			 * 文件路径, 当调用函数不存在时，会先从文件中加载
 			 */
-			"func_file": "./index.js",
+			func_file: './index.js',
 			/**
 			 * 回调函数名 用于决定调用脚本的哪个函数
 			 */
-			"func_name": "",
+			func_name: '',
 			/**
 			 * 排序
 			 */
-			"sort": 10,
+			sort: 10,
 			/**
 			 * 状态, 0表示未启用, 1表示启用
 			 */
-			"state": 1,
+			state: 1,
 			/**
 			 * 显示, 0表示不显示, 1表示显示
 			 */
-			"show": 0
+			show: 0
 		};
 
 		/**
@@ -94,394 +113,462 @@ class Item {
 
 /**
  * 设置配置
- * @param {Object} config 配置
+ * @param {Object} config 配置对象
  */
-Item.prototype.set_config = function(config) {
-	if (config && config.func_file !== this.config.func_file) {
+Item.prototype.set_config = function (config) {
+	if (!config) return;
+
+	// 如果func_file改变，重置加载状态
+	if (config.func_file !== this.config.func_file) {
 		this.complete = false;
 	}
-	this.config = conf(Object.assign({}, this.config, config || {}), this.filename);
-}
+
+	// 合并配置并应用配置处理
+	this.config = conf(Object.assign({}, this.config, config), this.filename);
+};
 
 /**
- * 设置配置后
+ * 设置配置后钩子方法
  */
-Item.prototype.set_config_after = function() {
-
+Item.prototype.set_config_after = function () {
+	// 空实现，供子类重写
 };
 
 /**
- * 新建脚本
- * @param {String} file
+ * 新建脚本文件
+ * @param {String} file 目标文件路径
  */
-Item.prototype.new_script = function(file) {
-	var fl = this.dir_base + "/script.js";
-	if (fl.hasFile()) {
-		fl.copyFile(file);
+Item.prototype.new_script = function (file) {
+	const templateFile = `${this.dir_base}/script.js`;
+	if (templateFile.hasFile()) {
+		templateFile.copyFile(file);
 	}
 };
 
 /**
  * 移除模块
- * @param {Object} m
+ * @param {Object|String} module 模块对象或路径
  */
-Item.prototype.remove_module = function(m) {
-	if (this.mode === 3 || this.mode === 4) {
-		// 移除模块和监听
-		$.mod.unload(m);
-	} else {
-		// 移除模块
-		var filename = require.resolve(m);
-		require.cache[filename] = null;
-		delete require.cache[filename];
+Item.prototype.remove_module = function (module) {
+	if (!module) return;
+
+	try {
+		if (this.mode === 3 || this.mode === 4) {
+			// 移除模块和监听
+			$.mod.unload(module);
+		} else {
+			// 移除模块缓存
+			const filename = require.resolve(module);
+			if (require.cache[filename]) {
+				require.cache[filename] = null;
+				delete require.cache[filename];
+			}
+		}
+	} catch (err) {
+		$.log.error(`移除模块失败: ${err.message}`);
 	}
 };
 
 /**
  * 卸载脚本
- * @param {String} file 文件
+ * @param {String} file 文件路径
  */
-Item.prototype.unload_script = function(file) {
+Item.prototype.unload_script = function (file) {
 	if (!file) {
-		var f = this.config.func_file;
-		if (f) {
-			file = f.fullname(this.dir)
+		const funcFile = this.config.func_file;
+		if (funcFile) {
+			file = funcFile.fullname(this.dir);
 		}
 	}
+
 	if (file) {
 		this.remove_module(file);
 	}
+
 	this.complete = false;
-}
+};
 
 /**
  * 重载脚本
- * @param {String} file 文件
  */
-Item.prototype.reload_script = function() {
+Item.prototype.reload_script = function () {
 	this.unload_script();
 	this.load_script();
-}
+};
 
 /**
- * 卸载
+ * 卸载钩子方法
  */
-Item.prototype.unload = async function() {
-
-}
+Item.prototype.unload = async function () {
+	// 空实现，供子类重写
+};
 
 /**
- * 卸载之后
+ * 卸载之后处理
  * @param {Boolean} remove 是否删除文件
  */
-Item.prototype.unload_after = async function(remove) {
+Item.prototype.unload_after = async function (remove) {
 	// 删除脚本
 	this.unload_script();
 	if (remove) {
 		this.remove_file();
 	}
-}
+};
 
 /**
  * 加载脚本
- * @param {String} file 文件
+ * @param {String} file 文件路径
  * @param {String} name 函数名
- * @returns {Object} 返回加载的模块对象
+ * @returns {Object|null} 返回加载的模块对象
  */
-Item.prototype.load_script = function(file, name = "") {
+Item.prototype.load_script = function (file, name = '') {
 	if (!file) {
-		var f = this.config.func_file;
-		if (f) {
-			file = f.fullname(this.dir);
+		const funcFile = this.config.func_file;
+		if (funcFile) {
+			file = funcFile.fullname(this.dir);
 			if (!file.hasFile()) {
 				this.new_script(file);
 			}
 		} else {
-			return;
+			return null;
 		}
 	}
+
 	if (!name) {
 		name = this.config.func_name;
 	}
-	var cs;
-	if (this.mode === 3 || this.mode === 4) {
-		cs = $.require(file, (cs, way) => {
-			if (way == "change" && cs) {
-				if (name) {
-					if (cs[name]) {
-						this.main = cs[name];
+
+	let cs;
+	try {
+		if (this.mode === 3 || this.mode === 4) {
+			cs = $.require(file, (loadedModule, changeType) => {
+				if (changeType === 'change' && loadedModule) {
+					if (name) {
+						if (loadedModule[name]) {
+							this.main = loadedModule[name];
+						}
+					} else if ($.push) {
+						$.push(this, loadedModule, true);
 					}
-				} else {
-					$.push(this, cs, true);
 				}
-			}
-		});
-	} else {
-		cs = require(file);
-	}
-	if (cs) {
-		if (name) {
-			if (cs[name]) {
-				this.main = cs[name];
-			}
+			});
 		} else {
-			$.push(this, cs, true);
+			cs = require(file);
 		}
+
+		if (cs) {
+			if (name) {
+				if (cs[name]) {
+					this.main = cs[name];
+				}
+			} else if ($.push) {
+				$.push(this, cs, true);
+			}
+		}
+
+		return cs;
+	} catch (err) {
+		$.log.error(`加载脚本失败: ${err.message}`);
+		return null;
 	}
-	return cs;
-}
+};
 
 /**
- * 新建配置
- * @param {String} file
+ * 新建配置文件
+ * @param {String} file 目标文件路径
  */
-Item.prototype.new_config = function(file) {
-	var fl = this.dir_base + "/config.tpl.json";
-	fl.copyFile(file);
+Item.prototype.new_config = function (file) {
+	const templateFile = `${this.dir_base}/config.tpl.json`;
+	templateFile.copyFile(file);
 };
 
 /**
  * 加载配置文件
  * @param {String} file 文件路径
  * @param {String} name 配置项名称
- * @return {Object} 配置对象
+ * @return {Object|null} 配置对象
  */
-Item.prototype.load_file = function(file, name) {
-	var config;
-	var f = file.fullname(this.dir);
-	var text = f.loadText();
-	if (!text) {
-		this.new_config(f);
-	}
-	if (text) {
-		if (this.mode === 2 || this.mode === 3 || this.mode === 4) {
-			config = $.loadJson(f, (conf, way) => {
-				if (way == "change" && conf) {
-					if (Array.isArray(conf)) {
-						var list = conf;
-						for (var i = 0; i < list.length; i++) {
-							var o = list[i];
-							if (this.config.name === o.name) {
-								this.set_config(o);
+Item.prototype.load_file = function (file, name) {
+	let config = null;
+	try {
+		const fullPath = file.fullname(this.dir);
+		let text = fullPath.loadText();
+
+		// 如果文件不存在，创建新的配置文件
+		if (!text) {
+			this.new_config(fullPath);
+			text = fullPath.loadText();
+		}
+
+		if (text) {
+			// 根据模式决定是否使用热更新加载
+			if (this.mode === 2 || this.mode === 3 || this.mode === 4) {
+				config = $.loadJson(fullPath, function (loadedConfig, changeType) {
+					if (changeType === 'change' && loadedConfig) {
+						try {
+							if (Array.isArray(loadedConfig)) {
+								// 在数组中查找匹配的配置项
+								const targetConfig = loadedConfig.find(item => item.name === this.config.name);
+								if (targetConfig) {
+									this.set_config(targetConfig);
+									this.set_config_after();
+									// 根据模式决定是否重新加载脚本
+									if (this.mode === 3 || this.mode === 4) {
+										this.reload_script();
+									}
+								}
+							} else {
+								this.set_config(loadedConfig);
 								this.set_config_after();
 								if (this.mode === 3 || this.mode === 4) {
 									this.reload_script();
 								}
-								break;
 							}
-						}
-					} else {
-						this.set_config(conf);
-						this.set_config_after();
-						if (this.mode === 3 || this.mode === 4) {
-							this.reload_script();
+						} catch (err) {
+							$.log.error(`配置热更新失败: ${err.message}`);
 						}
 					}
-				}
-			});
-		} else {
-			config = f.loadJson();
-		}
+				}.bind(this));
+			} else {
+				config = fullPath.loadJson();
+			}
 
-		if (name) {
-			if (Array.isArray(config)) {
-				var list = config;
-				for (var i = 0; i < list.length; i++) {
-					var o = list[i];
-					if (name === o.name) {
-						config = o;
-						break;
-					}
-				}
+			// 如果指定了名称且配置是数组，查找匹配项
+			if (name && Array.isArray(config)) {
+				config = config.find(item => item.name === name) || null;
 			}
 		}
+
+		// 更新目录和文件名引用
+		this.dir = fullPath.dirname();
+		this.filename = fullPath;
+		return config;
+	} catch (err) {
+		$.log.error(`加载配置文件失败: ${err.message}`);
+		return null;
 	}
-	this.dir = f.dirname();
-	this.filename = f;
-	return config;
 };
 
 /**
- * 删除文件
+ * 删除目录
  */
-Item.prototype.del_dir = function() {
-	var f = this.config.func_file;
-	if (f) {
+Item.prototype.del_dir = function () {
+	const funcFile = this.config.func_file;
+	if (funcFile && $.dir && $.dir.del) {
 		$.dir.del(this.dir);
 	}
 };
 
 /**
  * 删除配置和脚本文件
- * @param {Object} item 项目
+ * @returns {String|null} 错误消息，如果没有错误则返回null
  */
-Item.prototype.remove_file = function() {
-	var name = this.config.name;
-	var file = this.filename;
-
-	var msg = null;
-	if (file.hasFile()) {
-		var text = file.loadText();
-		if (text) {
-			var jarr = text.toJson();
-			if (jarr.constructor == Array) {
-				for (var i = 0; i < jarr.length; i++) {
-					var o = jarr[i];
-					if (name === o.name) {
+Item.prototype.remove_file = function () {
+	const name = this.config.name;
+	const file = this.filename;
+
+	let errorMessage = null;
+	try {
+		if (file && file.hasFile) {
+			if (file.hasFile()) {
+				const text = file.loadText();
+				if (text) {
+					const config = text.toJson();
+					if (Array.isArray(config)) {
+						// 在数组配置中查找并删除指定项
+						const index = config.findIndex(item => item.name === name);
+						if (index !== -1) {
+							this.del_dir();
+							config.splice(index, 1);
+						}
+						// 根据剩余配置决定保存或删除文件
+						if (config.length > 0) {
+							file.saveText(JSON.stringify(config, null, 4));
+						} else if (file.delFile) {
+							file.delFile();
+						}
+					} else {
+						// 单个配置直接删除目录
 						this.del_dir();
-						jarr.splice(i, 1);
-						break;
 					}
-				}
-				if (jarr.length) {
-					file.saveText(JSON.stringify(jarr, null, 4));
 				} else {
-					file.delFile();
+					this.del_dir();
 				}
 			} else {
-				this.del_dir();
+				errorMessage = '配置文件不存在';
 			}
-		} else {
-			this.del_dir();
 		}
-	} else {
-		msg = "配置文件不存在";
+	} catch (err) {
+		$.log.error(`删除文件失败: ${err.message}`);
+		errorMessage = `删除失败: ${err.message}`;
 	}
-	return msg;
+	return errorMessage;
 };
 
 /**
  * 载入配置
- * @param {Object|String} conf 配置对象或配置路径
+ * @param {Object|String} configData 配置对象或配置路径
  * @param {String} name 配置名称
  */
-Item.prototype.load_config = function(conf, name) {
-	var config;
-	if (conf) {
-		if (typeof(conf) === "string") {
-			config = this.load_file(conf, name);
+Item.prototype.load_config = function (configData, name) {
+	let config;
+	try {
+		if (configData) {
+			if (typeof configData === 'string') {
+				config = this.load_file(configData, name);
+			} else {
+				config = configData;
+			}
 		} else {
-			config = conf;
+			config = this.load_file(this.filename, name);
 		}
-	} else {
-		config = this.load_file(this.filename, name);
+
+		this.set_config(config);
+		this.set_config_after();
+	} catch (err) {
+		$.log.error(`载入配置失败: ${err.message}`);
 	}
-	this.set_config(config);
-	this.set_config_after();
 };
 
 /**
- * 加载前
+ * 加载前处理
  */
-Item.prototype.load_before = async function() {
-	var cs = this.load_script();
-	if (cs) {
-		this.complete = true;
+Item.prototype.load_before = async function () {
+	try {
+		const module = this.load_script();
+		if (module) {
+			this.complete = true;
+		}
+	} catch (err) {
+		$.log.error(`加载前处理失败: ${err.message}`);
+		this.complete = false;
 	}
-}
+};
 
 /**
- * 加载
+ * 加载处理
  */
-Item.prototype.load = async function() {
-	// 加载前
-}
+Item.prototype.load = async function () {
+	// 空实现，供子类重写
+};
 
 /**
  * 重载配置和脚本
  */
-Item.prototype.reload = async function() {
+Item.prototype.reload = async function () {
 	await this.run('unload');
 	await this.run('load');
-}
+};
 
 /**
  * 保存配置
  */
-Item.prototype.save = function() {
-	var f = this.filename.fullname(this.dir);
-	var text = f.loadText();
-	if (text) {
-		if (text.trim().startsWith('[')) {
-			var jarr = text.toJson();
-			for (var i = 0; i < jarr.length; i++) {
-				if (jarr[i].name === this.config.name) {
-					jarr[i] = this.config;
-					break;
+Item.prototype.save = function () {
+	try {
+		if (!this.filename) return;
+
+		const fullPath = this.filename.fullname(this.dir);
+		const text = fullPath.loadText();
+
+		if (text && text.trim().startsWith('[')) {
+			// 数组格式配置
+			const configArray = text.toJson();
+			if (Array.isArray(configArray)) {
+				// 查找并更新现有配置项
+				const existingIndex = configArray.findIndex(item => item.name === this.config.name);
+				if (existingIndex !== -1) {
+					configArray[existingIndex] = this.config;
+				} else {
+					// 如果不存在，添加新配置项
+					configArray.push(this.config);
 				}
+				fullPath.saveText(JSON.stringify(configArray, null, 4));
+				return;
 			}
-			var txt = JSON.stringify(jarr, null, 4);
-			f.saveText(txt);
-			return;
 		}
+
+		// 单对象格式配置，直接保存
+		fullPath.saveText(JSON.stringify(this.config, null, 4));
+	} catch (err) {
+		$.log.error(`保存配置失败: ${err.message}`);
 	}
-	var txt = JSON.stringify(this.config, null, 4);
-	f.saveText(txt);
 };
 
 /**
  * 主要执行函数
- * @param {Object} params 参数集合
+ * @param {*} params 参数集合
+ * @returns {Promise<any>} 执行结果
  */
-Item.prototype.main = async function(...params) {
-	// console.log("未实现", params);
+Item.prototype.main = async function (...params) {
+	// 空实现，供子类重写
 	return null;
 };
 
 /**
- * 运行
- * @param {Object} params 参数集合
+ * 运行主函数
+ * @param {*} params 参数集合
+ * @returns {Promise<any>} 执行结果
  */
-Item.prototype.run = async function(...params) {
-	return await this.exec("main", ...params);
-}
+Item.prototype.run = async function (...params) {
+	return await this.exec('main', ...params);
+};
 
 /**
- * 调用函数
+ * 调用函数（核心执行方法）
  * @param {String} method 函数名
- * @param {Object} params 参数集合
- * @return {Object} 执行结果
+ * @param {*} params 参数集合
+ * @returns {Promise<any>} 执行结果
  */
-Item.prototype.exec = async function(method, ...params) {
-	if (this[method]) {
-		var ret;
-		if (this[method + "_before"]) {
+Item.prototype.exec = async function (method, ...params) {
+	if (!this[method]) {
+		return null;
+	}
+
+	let result;
+
+	try {
+		// 执行前置钩子
+		const beforeMethod = `${method}_before`;
+		if (this[beforeMethod]) {
 			try {
-				ret = this[method + "_before"](...params);
+				result = this[beforeMethod](...params);
+				if (util.types.isPromise(result)) {
+					result = await result;
+				}
 			} catch (err) {
-				$.log.error("执行前失败！", err);
+				$.log.error(`执行前置钩子 ${beforeMethod} 失败: ${err.message}`);
 			}
-			if (util.types.isPromise(ret)) {
-				ret = await ret;
-			}
-		}
-		try {
-			ret = this[method](...params);
-		} catch (err) {
-			$.log.error("执行时失败！", err);
-		}
-		if (util.types.isPromise(ret)) {
-			ret = await ret;
 		}
-		// console.log(this.config.name + "-" + method + "内容", ret);
-		if (this[method + "_after"]) {
+
+		// 执行主方法
+		const methodResult = this[method](...params);
+		result = util.types.isPromise(methodResult) ? await methodResult : methodResult;
+
+		// 执行后置钩子
+		const afterMethod = `${method}_after`;
+		if (this[afterMethod]) {
 			try {
-				var result = this[method + "_after"](ret, ...params);
-				if (util.types.isPromise(result)) {
-					result = await result;
-				}
-				if (result) {
-					ret = result;
+				const afterResult = this[afterMethod](result, ...params);
+				if (util.types.isPromise(afterResult)) {
+					const resolvedAfterResult = await afterResult;
+					if (resolvedAfterResult !== undefined) {
+						result = resolvedAfterResult;
+					}
+				} else if (afterResult !== undefined) {
+					result = afterResult;
 				}
 			} catch (err) {
-				$.log.error("执行后失败！", err);
+				$.log.error(`执行后置钩子 ${afterMethod} 失败: ${err.message}`);
 			}
 		}
-		return ret
+	} catch (err) {
+		$.log.error(`执行方法 ${method} 失败: ${err.message}`);
+		return null;
 	}
+	return result;
 };
 
 /**
- * @module 导出Drive类
+ * @module 导出Item类
  */
 module.exports = Item;