go-admingo-admin
  • 指南
  • 开发
    • 进阶
    • 指令
  • 前端
  • 高阶
  • 授权
  • 帮助
  • GitHub
  • Changelog
⌘ K
标准写法
标准模块开发
服务端基础
后端目录结构
后端配置文件
启动后端服务
前端基础
前端目录结构
前端配置文件
启动前端服务
开发模式
Actions 模式
常规模式
第一个接口
分层开发
API 层
Service 层
DTO 定义
Model 定义
路由注册
多环境配置
数据库表规范
数据权限
统一响应
代码生成
生成前配置
生成业务代码
一键生成菜单
菜单绑定接口
配置角色权限
验证功能
用 AI 生成代码
进阶能力
Runtime 核心 API
认证与鉴权
日志
请求追踪
缓存
队列
文件上传
限流
定时任务
Air 热加载
Swagger 文档
代码生成工具
最后更新时间:
Open-source MIT Licensed | Copyright © 2020-present
Powered by go-admin-team

TABLE OF CONTENTS

‌
‌
‌
‌

常规模式

INFO

go-admin 有两种开发模式,按业务复杂度选择:

  1. Actions 模式 —— 单表增删改查优先使用。common/actions 提供的五个通用 Action 已覆盖参数绑定、数据权限过滤、操作人注入、分页与错误响应,一个模块只需 model、dto、router 三个文件,无需编写 apis 与 service。
  2. 常规模式(本页) —— 当业务超出单表 CRUD(跨表事务、外部调用、复杂校验)时, 自行编写 Handler 与 Service。

可编译的完整示例见仓库的 app/demo/ 目录,与本文冲突时以该目录为准。

首先说明一下结构: 这里只是针对app文件夹说明;

bash
.
└── admin
   ├── apis
   ├── models
   ├── router
   └── service

admin:可以理解成一个 project

apis:是 project 的 api 文件

models:是 project 的数据库层的模型

router:是 project 的路由

service:是 project 的业务逻辑处理

service.dto:是 project 的 api 对应的数据接收以及解析模型

搞清楚了这些我们开始往下进行;

直接使用项目中的源代码进行说明:我们操作日志为例;

按照 models、service.dto、service、apis、router 这个顺序来说明;

以上几个模块可以分别对应查看。

WARNING

从哪里获得帮助:

如果你在阅读本教程的过程中有任何疑问,可以前往提交建议。