mm_os 3.3.1 → 4.0.0

package/core/component/config.tpl.json

@@ -0,0 +1,63 @@
+{
+  // 名称
+  "name": "${name}",
+  // 标题
+  "title": "角色信息",
+  // 描述
+  "description": "定义角色信息的组件",
+  // 状态 0：禁用 1：启用
+  "state": 1,
+  // 排序，越小越靠前
+  "sort": 10,
+  // 组件包含字段
+  "fields": {
+    "id": {
+      "type": "string",
+      "title": "角色ID",
+      "description": "角色的唯一标识符",
+      "min": 1,
+      "max": 10000000,
+      "default": "role_10000000"
+    },
+    "name": {
+      "type": "string",
+      "title": "角色名称",
+      "description": "角色的显示名称",
+      "min": 1,
+      "max": 24,
+      "default": "张三"
+    },
+    "description": {
+      "type": "string",
+      "title": "角色描述",
+      "description": "角色的详细说明",
+      "min": 1,
+      "max": 255,
+      "default": "一个普通的角色"
+    },
+    "type_id": {
+      "type": "number",
+      "title": "类型ID",
+      "description": "角色的类型ID",
+      "min": 1,
+      "max": 10000000,
+      "default": 1
+    },
+    "race": {
+      "type": "string",
+      "title": "种族",
+      "description": "角色的种族",
+      "min": 1,
+      "max": 10000000,
+      "default": "人族"
+    },
+    "age": {
+      "type": "number",
+      "title": "年龄",
+      "description": "角色的年龄",
+      "min": 1,
+      "max": 10000,
+      "default": 16
+    }
+  }
+}

package/core/component/index.js

@@ -0,0 +1,273 @@
+const { Drive } = require('mm_machine');
+const Comp = require('./component.js');
+
+/**
+ * 组件基类
+ * 纯粹的组件数据容器，不包含任何业务逻辑
+ * 只负责定义组件的数据结构和验证规则
+ */
+class Component extends Drive {
+  static config = {
+    'name': 'default',
+    'title': '组件',
+    'main': '',
+    'sort': 10
+  };
+
+  /**
+   * 构造函数
+   * @param {object} config 配置参数
+   * @param {object} parent 父对象
+   */
+  constructor(config, parent) {
+    super({ ...Component.config, ...config || {} }, parent);
+  }
+}
+
+/**
+ * 获取模板目录
+ * @returns {string} 模板目录
+ */
+Component.prototype.getTplDir = function() {
+  return __dirname;
+};
+
+/**
+ * 获取组件字段定义
+ * @returns {object} 组件字段定义
+ */
+Component.prototype.getFields = function () {
+  return this.config.fields || {};
+};
+
+/**
+ * 创建组件数据实例
+ * @param {object} data 组件数据
+ * @returns {object} 组件数据实例
+ */
+Component.prototype.create = function (data = {}) {
+  if (typeof data !== 'object' || Array.isArray(data)) {
+    throw new TypeError('组件数据必须是对象');
+  }
+
+  let component = new Comp();
+  let fields = this.getFields();
+  
+  for (let field_name in fields) {
+    let rule = fields[field_name];
+    let field_value = data[field_name];
+    component[field_name] = this._getDefaultValue(field_value, rule);
+  }
+  component.isDirty(false);
+  return component;
+};
+
+/**
+ * 获取字段默认值
+ * @param {*} field_value 字段值
+ * @param {object} rule 规则
+ * @returns {*} 默认值
+ */
+Component.prototype._getDefaultValue = function(field_value, rule) {
+  if (field_value !== undefined) {
+    return field_value;
+  }
+  if (rule.default !== undefined) {
+    return rule.default;
+  }
+  return this._getTypeDefault(rule.type);
+};
+
+/**
+ * 根据类型获取默认值
+ * @param {string} type 类型
+ * @returns {*} 默认值
+ */
+Component.prototype._getTypeDefault = function(type) {
+  const defaults = {
+    'number': 0,
+    'string': '',
+    'boolean': false,
+    'object': {},
+    'array': []
+  };
+  return defaults[type] !== undefined ? defaults[type] : null;
+};
+
+/**
+ * 验证必填字段
+ * @param {string} field_name 字段名
+ * @param {*} field_value 字段值
+ * @param {object} rule 验证规则
+ * @returns {string|undefined} 错误信息
+ */
+Component.prototype._validateRequired = function (field_name, field_value, rule) {
+  if (rule.required && (field_value === undefined || field_value === null || field_value === '')) {
+    return `${field_name} 是必填字段`;
+  }
+};
+
+/**
+ * 验证字段类型
+ * @param {string} field_name 字段名
+ * @param {*} field_value 字段值
+ * @param {object} rule 验证规则
+ * @returns {string|undefined} 错误信息
+ */
+Component.prototype._validateType = function (field_name, field_value, rule) {
+  if (rule.type && typeof field_value !== rule.type) {
+    return `${field_name} 必须是 ${rule.type} 类型`;
+  }
+};
+
+/**
+ * 验证字段范围
+ * @param {string} field_name 字段名
+ * @param {*} field_value 字段值
+ * @param {object} rule 验证规则
+ * @returns {string|undefined} 错误信息
+ */
+Component.prototype._validateRange = function (field_name, field_value, rule) {
+  if (rule.min !== undefined && field_value < rule.min) {
+    return `${field_name} 不能小于 ${rule.min}`;
+  }
+  if (rule.max !== undefined && field_value > rule.max) {
+    return `${field_name} 不能大于 ${rule.max}`;
+  }
+};
+
+/**
+ * 验证字段长度
+ * @param {string} field_name 字段名
+ * @param {*} field_value 字段值
+ * @param {object} rule 验证规则
+ * @returns {string|undefined} 错误信息
+ */
+Component.prototype._validateLength = function (field_name, field_value, rule) {
+  if (rule.min_length !== undefined && field_value.length < rule.min_length) {
+    return `${field_name} 长度不能小于 ${rule.min_length}`;
+  }
+  if (rule.max_length !== undefined && field_value.length > rule.max_length) {
+    return `${field_name} 长度不能大于 ${rule.max_length}`;
+  }
+};
+
+/**
+ * 验证字段格式
+ * @param {string} field_name 字段名
+ * @param {*} field_value 字段值
+ * @param {object} rule 验证规则
+ * @returns {string|undefined} 错误信息
+ */
+Component.prototype._validateFormat = function (field_name, field_value, rule) {
+  if (rule.pattern && !rule.pattern.test(field_value)) {
+    return `${field_name} 格式不正确`;
+  }
+  if (rule.enum && !rule.enum.includes(field_value)) {
+    return `${field_name} 的值必须是 ${rule.enum.join('、')}`;
+  }
+};
+
+/**
+ * 验证单个字段
+ * @param {string} field_name 字段名
+ * @param {*} field_value 字段值
+ * @param {object} rule 验证规则
+ * @returns {string|undefined} 错误信息
+ */
+Component.prototype._validateField = function (field_name, field_value, rule) {
+  var error = this._validateRequired(field_name, field_value, rule);
+  if (error) return error;
+  if (field_value === undefined || field_value === null) return;
+  error = this._validateType(field_name, field_value, rule);
+  if (error) return error;
+  error = this._validateRange(field_name, field_value, rule);
+  if (error) return error;
+  error = this._validateLength(field_name, field_value, rule);
+  if (error) return error;
+  return this._validateFormat(field_name, field_value, rule);
+};
+
+/**
+ * 验证组件数据
+ * @param {object} data 组件数据
+ * @returns {object} 验证结果
+ */
+Component.prototype.validate = function (data) {
+  if (typeof data !== 'object' || Array.isArray(data)) {
+    throw new TypeError('验证数据必须是对象');
+  }
+  const errors = {};
+  let fields = this.getFields();
+  for (let field_name in fields) {
+    let error = this._validateField(field_name, data[field_name], fields[field_name]);
+    if (error) errors[field_name] = error;
+  }
+  return { valid: Object.keys(errors).length === 0, errors };
+};
+
+/**
+ * 获取组件类型
+ * @returns {string} 组件类型
+ */
+Component.prototype.getType = function () {
+  return this.config.name;
+};
+
+/**
+ * 获取组件标题
+ * @returns {string} 组件标题
+ */
+Component.prototype.getTitle = function () {
+  return this.config.title;
+};
+
+/**
+ * 获取组件描述
+ * @returns {string} 组件描述
+ */
+Component.prototype.getDescription = function () {
+  return this.config.description || '';
+};
+
+/**
+ * 转换为JSON字符串
+ * @param {object} component 组件数据
+ * @returns {string} JSON字符串
+ */
+Component.prototype.toJson = function (component) {
+  // 参数校验
+  if (typeof component !== 'object' || Array.isArray(component)) {
+    throw new TypeError('组件数据必须是对象');
+  }
+  return JSON.stringify(component);
+};
+
+/**
+ * 从JSON字符串创建组件数据
+ * @param {string} json_str JSON字符串
+ * @returns {object} 组件数据
+ */
+Component.prototype.fromJson = function (json_str) {
+  // 参数校验
+  if (typeof json_str !== 'string') {
+    throw new TypeError('JSON字符串必须是字符串');
+  }
+
+  let data = JSON.parse(json_str);
+  return this.create(data);
+};
+
+/**
+ * 初始化组件核心
+ * @param {object} logger 日志对象
+ */
+Component.prototype._initCore = async function (logger) {
+  // 日志对象
+  if (logger) {
+    this.setLogger(logger);
+  }
+};
+
+// 导出模块
+exports.Component = Component;

package/core/component/script.tpl.js

@@ -0,0 +1,19 @@
+/**
+ * 组件，主要用于游戏
+ */
+module.exports = {
+  /**
+   * 初始化
+   */
+  async _init() {
+    // this.log('debug', `初始化！`);
+  },
+  /**
+   * 主要逻辑
+   * @param {...any} args 逻辑参数
+   */
+  async main(...args) {
+    this.log('debug', `主要逻辑被调用`, { args });
+    // 主要代码写在这
+  }
+};

package/core/controller/config.tpl.json

@@ -0,0 +1,14 @@
+{
+  // 名称
+  "name": "${name}",
+  // 标题
+  "title": "${title || '示例控制器'}",
+  // 描述
+  "description": "${description || '示例描述'}",
+  // 主文件
+  "main": "${main || 'index.js'}",
+  // 状态 0：禁用 1：启用
+  "state": 1,
+  // 排序，越小越靠前
+  "sort": 100
+}