mm_dbs 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,3 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## 数据库框架（mm_db）
+用于mysql数据库生成表或生成sql模板，通过设计数据库就可以生成sql模板，或通过db.json配置文件就可以生成mysql数据表
+可以便捷的实现数据库架构设计和相应业务的API

package/com.json

@@ -0,0 +1,5 @@
+{
+    "name": "DB",
+    "title": "数据管理器",
+    "state": 1
+}

package/example/index.js

@@ -0,0 +1,50 @@
+/**
+ * mm_dbs 数据库框架示例
+ * 演示 dbAdmin() 获取管理器、manager.add() 注册驱动（不连接真实数据库），
+ * 以及 Db.model() 字段模型生成与字段 SQL 模板生成。
+ * 运行：node example/index.js
+ */
+const { Db, Manager, dbAdmin } = require('../index.js');
+
+/**
+ * 主流程
+ */
+function main() {
+  // 方式1：通过工厂函数获取数据库管理器实例
+  const manager = dbAdmin('example');
+  console.log('工厂实例是 Manager 类型:', manager instanceof Manager);
+  console.log('admin 缓存同作用域实例:', dbAdmin('example') === manager);
+
+  // 方式2：注册一个数据库驱动（仅注册配置，不建立连接）
+  const drive = manager.add({
+    name: 'user',
+    title: '用户表',
+    table: 'user'
+  });
+  console.log('驱动是 Db 类型:', drive instanceof Db);
+  console.log('驱动表名:', drive.config.table);
+
+  // 通过字段描述生成字段模型
+  const idModel = drive.model({
+    name: 'id',
+    type: 'int(11)',
+    note: '编号:唯一标识',
+    pk: true,
+    auto: true,
+    notnull: true
+  });
+  const nameModel = drive.model({
+    name: 'name',
+    type: 'varchar(50)',
+    note: '姓名:长度[2,50]',
+    notnull: true
+  });
+  console.log('主键字段模型:', JSON.stringify(idModel, null, 2));
+  console.log('姓名字段模型:', JSON.stringify(nameModel, null, 2));
+
+  // 生成字段 SQL 模板（纯逻辑，无需数据库连接）
+  console.log('主键字段 SQL:', drive._generateFieldSql(idModel));
+  console.log('姓名字段 SQL:', drive._generateFieldSql(nameModel));
+}
+
+main();

package/index.js

@@ -0,0 +1,24 @@
+const Manager = require('./lib/manager');
+const Admin = require('mm_corejs').Admin;
+
+const admin = new Admin();
+admin.setClass(Manager);
+
+module.exports = {
+  Db: require('./lib/db'),
+  Manager,
+  admin,
+  /**
+   * 获取数据库管理器实例
+   * @param {String} scope 作用域名称
+   * @param {Object} config 配置参数
+   * @param {Object} os 操作系统实例
+   * @returns {Manager} 数据库管理器实例
+   */
+  dbAdmin(scope, config = {}, os) {
+    if (!scope) {
+      scope = 'os';
+    }
+    return admin.get(scope, config, os);
+  }
+};