30分钟完成第一个 CRUD

使用 Forge Admin 代码生成器，你可以快速完成一个完整的增删改查功能，无需手写重复代码。

前提条件

• 已按首次启动流程完成环境搭建
• 后端和前端均已正常运行
• 已使用 admin/123456 成功登录

步骤一：导入数据库表

首先在数据库中创建一个测试表：

USE forge_admin;

CREATE TABLE IF NOT EXISTS `demo_goods` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `tenant_id` bigint NOT NULL DEFAULT 1,
  `name` varchar(100) NOT NULL COMMENT '商品名称',
  `price` decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT '价格',
  `stock` int NOT NULL DEFAULT 0 COMMENT '库存',
  `status` tinyint NOT NULL DEFAULT 0 COMMENT '状态 0下架 1上架',
  `create_by` bigint DEFAULT NULL,
  `create_time` datetime DEFAULT NULL,
  `create_dept` bigint DEFAULT NULL,
  `update_by` bigint DEFAULT NULL,
  `update_time` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='演示商品表';

步骤二：进入代码生成器

1. 在左侧菜单找到「代码生成」入口
2. 点击「导入表」
3. 选择 demo_goods 表
4. 点击确认导入

步骤三：配置字段

导入后，对字段进行配置：

字段	配置项	值
name	插入/编辑/列表/查询	✓
name	查询方式	LIKE
price	插入/编辑/列表	✓
stock	插入/编辑/列表	✓
status	插入/编辑/列表	✓
status	显示类型	下拉框

步骤四：生成代码

1. 点击「代码生成」按钮
2. 在预览窗口查看生成的文件列表
3. 点击「下载」获取代码包

生成的文件包括：

层级	文件	说明
Entity	DemoGoods.java	数据库实体
Mapper	DemoGoodsMapper.java + XML	数据访问层
Service	DemoGoodsService.java + Impl	业务逻辑层
Controller	DemoGoodsController.java	REST 控制器
DTO/VO	DemoGoodsDto.java / DemoGoodsVo.java	数据传输对象
前端页面	index.vue	CRUD 页面
前端 API	demoGoods.js	接口定义

步骤五：复制到工程

后端：

• 将 Java 文件按包结构复制到对应目录
• 将 Mapper XML 复制到 resources/mapper/ 下

前端：

• 将 index.vue 复制到 src/views/demo/goods/
• 将 demoGoods.js 复制到 src/api/demo/

步骤六：重启验证

重启后端服务和前端，在菜单中配置新的页面入口，即可访问和使用你生成的 CRUD 页面。

总结

通过代码生成器，你只需要：

1. 设计数据库表（5分钟）
2. 导入表并配置字段（10分钟）
3. 生成并复制代码（5分钟）
4. 重启验证（10分钟）

总计约 30 分钟完成一个完整的 CRUD 功能。