10.8 实战案例

概述

以「案例演示」模块为例，演示代码生成器的完整使用流程。

第 1 步：建表

CREATE TABLE think_example (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(200) NOT NULL COMMENT '案例名称',
    type TINYINT(1) DEFAULT 0 COMMENT '案例类型',
    status TINYINT(1) DEFAULT 0 COMMENT '案例状态',
    sort INT DEFAULT 0 COMMENT '排序',
    avatar VARCHAR(500) DEFAULT '' COMMENT '头像',
    is_delete TINYINT(1) DEFAULT 0,
    create_user VARCHAR(50) DEFAULT '',
    create_time DATETIME,
    update_user VARCHAR(50) DEFAULT '',
    update_time DATETIME
);

第 2 步：代码生成器操作

1. 进入「工具管理 → 代码生成」
2. 找到 think_example 表
3. 配置：
   • 模块名：example
   • 功能名：案例演示
   • 作者：admin
   • 是否导入导出：是
4. 点击「预览」查看生成代码
5. 点击「生成」创建文件

第 3 步：生成的文件

app/controller/ExampleController.php    # 控制器
app/logic/ExampleLogic.php              # 业务逻辑
app/model/Example.php                   # 数据模型
app/validate/ExampleValidate.php        # 验证器
ui/src/api/tool/example.ts              # 前端 API
ui/src/views/tool/example/index.vue     # 列表页
ui/src/views/tool/example/edit.vue      # 编辑弹窗
ui/src/views/tool/example/detail.vue    # 详情弹窗
ui/src/views/tool/example/columns.ts    # 表格列配置
ui/src/views/tool/example/querySchemas.ts # 查询表单配置

第 4 步：后续操作

生成完成后，以下内容已自动创建：

项目	状态	说明
路由	✅ 自动注册	route/app.php 中已插入 CRUD 路由组
菜单	✅ 自动创建	主菜单和权限节点已创建
字典	✅ 自动创建	带选项的字段已创建字典和字典项

通常还需要手动调整：

1. 根据业务需求调整 Logic 属性配置（如 pageLikeFields、pageEqFields）
2. 补充自定义钩子（如 beforeDelete、afterDetail 等）
3. 在菜单管理中调整菜单排序和图标

生成后调整

生成的代码是基础骨架，通常需要：

• 调整 Logic 的查询条件配置
• 添加删除前校验（beforeDelete）
• 补充详情后的关联数据（afterDetail）
• 配置文件字段和富文本字段