当前位置： 首页 > news >正文

从 PHP 到 AI + Golang，程序员自救转型手记（六）：泛型基服务、控制器、仓储实现，自动发现和注册业务路由

news 2026/6/25 22:27:42

这是一个系列 Blog，作者将以一个 PHP 全栈工程师的身份，利用 AI 工具（claude code、codex、deepseek、豆包等）：从零开始学习 golang 语言，并最终完成 ai-go-mall（github | gitee）开源项目的制作，全程记录分享。

在上一期，我们已经完成 “注册数据库中间件、初始化模型结构和自动迁移”，本期将完成：泛型基服务、控制器、仓储实现，自动发现和注册业务路由

泛型基服务、控制器、仓储实现

由于对大型 golang 项目基类还不熟悉，直接同时让各大 AI：给我一套 golang WEB 项目的 Handler → Service → Repository → Model 的完整示例代码。

拿到示例代码后，作者逐行做了仔细阅读，并又问了一些问题，加粗字体为结论（以下问题只是作者在阅读代码时，对不理解的地方提出的疑问，读者可根据自己的实际情况提问和研究）：

  1. 为什么 admin_repo.go，admin_service.go 都有后缀，而 model 不需要叫做 admin_model.go 呢？因为不加后缀结构体重名、无法使用
  2. NewAdminHandler、NewAdminService、NewAdminRepository 是 golang 标准写法吗？是的，golang 官方也这么写
  3. 包名已经含有 admin 了，NewAdminRepository中是否可以省略 Admin？可以省略
  4. service 和 repository 层额外定义 interface，不直接使用结构体，以解耦、方便测试、方便扩展等

理解了豆包、文心一言提供的示例代码之后，我开始让 cc 直接在项目中写一套基础的代码出来：

  1. 写一个通用的 CRUD 实现，通用文件于 Handler → Service → Repository 对应目录建立，均以 base.go 命名
  2. service 和 repository 层额外定义 interface，不直接使用结构体
  3. 实现 Create、List、Edit、Delete 四个方法，其中 Edit 分为 GET 和 POST 两种请求方式，GET 为获取被修改的行数据，POST 为修改数据
  4. 只使用 GET 和 POST 两种请求方式，不使用 PUT 和 DELETE 等请求方式（除 GET/POST 外的请求方式，在国内的 CDN/全站加速 兼容极差）
# 大模型是概率生成，不是固定查表，再加上采样策略、上下文、版本等影响，同问题输出都会有差异，以下 AI 输出、包括生成的代码仅供参考，可直接忽略，继续向下查看如何寻找问题和完成整改全部完成！三个文件已创建并通过编译验证。以下是实现总结： --- 新建文件1. internal/repository/base.go — 数据访问层 ┌──────┬────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ 项目 │ 内容 │ ├──────┼────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 接口 │ CrudRepository[T any]│ ├──────┼────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 实现 │ genericCrudRepository[T any]│ ├──────┼────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 方法 │ Create、GetByID、List、Update、Delete │ ├──────┼────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 特点 │ List 使用 GORM Scopes 灵活组合筛选条件；Update 支持 map[string]any 部分更新；Delete 自动适配软删除 │ └──────┴────────────────────────────────────────────────────────────────────────────────────────────────────┘2. internal/service/base.go — 业务逻辑层 ┌──────┬─────────────────────────────────────────────────────────────────────┐ │ 项目 │ 内容 │ ├──────┼─────────────────────────────────────────────────────────────────────┤ │ 接口 │ CrudService[T any]│ ├──────┼─────────────────────────────────────────────────────────────────────┤ │ 实现 │ genericCrudService[T any]│ ├──────┼─────────────────────────────────────────────────────────────────────┤ │ 方法 │ Create、GetByID、List、Update、Delete │ ├──────┼─────────────────────────────────────────────────────────────────────┤ │ 特点 │ 基础实现直接委托 Repository；子类可覆写添加业务校验（如权限、去重） │ └──────┴─────────────────────────────────────────────────────────────────────┘3. internal/handler/base.go — 控制器层 ┌───────────────────────────┬──────────┬──────────────────────────────────┐ │ 路由 │ 方法 │ 说明 │ ├───────────────────────────┼──────────┼──────────────────────────────────┤ │ POST /{prefix}/create │ Create │ 新增记录 │ ├───────────────────────────┼──────────┼──────────────────────────────────┤ │ GET /{prefix}/list │ List │ 分页列表（?page=1&page_size=10） │ ├───────────────────────────┼──────────┼──────────────────────────────────┤ │ GET /{prefix}/:id/edit │ EditGet │ 获取被编辑的行数据 │ ├───────────────────────────┼──────────┼──────────────────────────────────┤ │ POST /{prefix}/:id/edit │ EditPost │ 执行修改 │ ├───────────────────────────┼──────────┼──────────────────────────────────┤ │ POST /{prefix}/:id/delete │ Delete │ 删除记录 │ └───────────────────────────┴──────────┴──────────────────────────────────┘ 统一响应格式：{"code":0/-1,"message":"...","data":{...}}后续使用方式示例 // 在 cmd/api/main.go 中初始化 userRepo :=repository.NewCrudRepository[model.User](database.GetDB())userSvc :=service.NewCrudService[model.User](userRepo)userHandler :=handler.NewCrudHandler[model.User](userSvc)userHandler.RegisterRoutes(r.Group("/user"))即可一键获得 /user 下的完整 CRUD 路由。 ✻ Crunchedfor5m 24s

首先检查目录结构的变更是否合理，有问题就先要求修改，目录结构没问题之后，才开始对代码review：

  1. AI 按要求创建了三个 base.go 文件，并没有创建多余的文件。
  2. AI 于repository/base.go建立了多个数据操作方法，分别是Delete、List、Create、GetByID，其中的 GetByID 方法用于根据主键 ID 查询单条记录，其命名规范算是 Go 社区惯例，但其余方法都是单个单词，所以这里特意将GetByID改名为了Row，干净利落，但此时单行是Row，多行的List当然应该改为Rows，相当于和 database/sql 风格保持一致。
  3. 此时Rows方法是支持分页的，传递了 page 和 page_size 等参数，而实际的项目中这里还得组装 where，order 等参数，AI 写的并不齐全，暂时干脆将 page 、page_size 也取消掉，保持基本实现即可，后续结合实际项目需求，再统一整理列表数据的查询方法。
  4. AI 使用了 GORMTraditional API的语法，这里要求它改写为更新的Generics API语法。
  5. interface 和 struct 命名问题，AI 使用了genericCrudRepository、CrudRepository等名称，基础的 CRUD 实现是很方便扩展的，假设扩展了还叫 xxCrud 就不合适，而且作为基础接口和结构体，当然是越简短越好，而且这些定义本身就在base.go文件内，直接改为Repository(struct)和IRepository(interface)等，干净利落。
  6. 控制器中 List 和 Edit 都被分为了两个处理方法，特别是 Edit，以 GET 和 POST 区分获取和编辑，一般需要又单独注册路由，所以干脆同 repo 层一样，以 Row 获取，以 Update 更新即可。

统一响应结构和函数单独要求 cc 修改，提出更多具体的要求：

  1. AI 将 Response（统一响应）的结构体和方法放在了 handler/base.go 中，这是跨 handler 共享的 API 契约（比如错误处理中间件），需要拆分出来，并且加上 Time 字段，让前端方便的做缓存、去重、排序等。
  2. AI 定义了多个响应函数，Success(200)、BadRequest（400）、NotFound（404）、InternalError（500）等，它们使用不同的 HTTP 状态码，这种方案又与 CDN/全站加速 不兼容，它们对非 200 的状态码处理完全是一团乱麻，所以这里改为统一响应 200，然后以 code 字段体现业务状态，直接删除了BadRequest（400）、NotFound（404）函数，InternalError暂留，增加了与Success对应的Fail快捷响应函数，统一使用 200 ok 状态码，code 则默认为 1
  3. 统一响应方法支持同时支持链式调用和函数式选项（Functional Options）两种调用方法：
  • 链式调用：response.New(c).Code(1).Message("测试").Send()
  • 函数式选项：response.Fail/Success(c, response.WithMessage("参数错误"), response.WithCode(1), response.WithData("test"))（函数式选项时，后三个参数都可以省略）

将以上整理出来的发给 AI，让其重新生成，根据使用模型的不同，可能还需要对话几轮，最终生成的代码已开源：

自动发现和注册业务路由

路由系统设计：

  1. 路由定义全部放入 @internal/router 目录
  2. 实现子级目录路由定义的自动发现（init + 空白导入的方案），建立专门的 @internal\router\registry\registry.go 文件来放置通用的 registry 函数，以及用来空白导入子目录路由文件触发 init
  3. 预设 /admin、/user、/ 三组示例路由，里边注册一个测试用的 /ping、/admin/ping、/user/ping 路由即可，其中 /ping 的路由注册放在 @internal/router/index.go 中，无需建立子目录
  4. @internal/router/router.go 实现 Setup 函数，后续于 main.go 内调用它即可完成全部业务路由的注册，Setup 中不要创建新的 r.Group，路由应该注册到那个分组，由各个子路由文件中的 init 决定

这里 AI 告诉我，我的提示词出了一点问题，@internal\router\registry\registry.go里边放置空白导入的代码，会造成循环导入，因为空白导入的包内，使用了registry函数，遂将方案改为于最外层的router.go中完成空白导入。

全部完成，编译通过 ✅。最终结构： internal/router/ ├── router.go# Setup() + 空白导入自动发现├── registry/ │ └── registry.go# Register(group, fn) + Setup(engine)├── admin/ │ └── admin.go# GET /admin/ping → "admin pong"├── user/ │ └── user.go# GET /user/ping → "user pong"└── index.go# GET /ping → "index pong"以后新增路由模块只需两步：新建子目录并 init()调 registry.Register()，然后在 router.go 加一行 _ 导入即可。 ✻ Cookedfor3m 46s

说几句题外话

  1. 发给 AI 的提示中：AI 于 xxx 建立了错误的文件，这里要求它改为 xxx这种第三人称的视角也是能直接用的，它能看懂，包括错别字，少量的模糊不清都没关系。
  2. 语言初学者写提示词时，往往会不确定自己对不对，可以直接让 AI 确定是否合理，如果合理则立即实现，否则取消并给出解释。
  3. 至此项目架构与地基已经完成，后续主要是业务面的东西，设计数据表，登录注册，CRUD 啥的，那些作者就很熟悉了，历时不到两个礼拜，终于回到了以往的 “舒适圈”。

今日产生的完整代码已经开源于：github | gitee

http://www.gsyq.cn/news/1589452.html

相关文章：

  • 线性回归实战：从数据到利润的商业建模指南
  • 一个项目对接N个团队，沟通到崩溃？公墓设计急需一站式的“省心方案”
  • 硬件安全引擎描述符机制：嵌入式网络加密加速的核心原理与实践
  • LLM基础原理与应用指南
  • 汽车调光玻璃透光率的太阳光模拟验证方法
  • MPC8315E安全引擎寄存器深度解析：MDEU、PKEU、RNGU实战配置与避坑指南
  • Windows 10 Microsoft Store 安装 Ubuntu 的默认目录及迁移指南
  • XGBoost标签噪声识别与清洗实战指南
  • 从素材库快速做歌的平台
  • 跨平台全栈开发神器FlyEnv，秒速切换多语言环境
  • Adobe-GenP 3.0完整指南：三步解锁Adobe全家桶的简单方案
  • 3步永久免费激活IDM：解锁Internet Download Manager完整功能的终极指南
  • 革命性Koikatsu Sunshine完整优化方案：一键解锁专业级角色创作体验
  • 如何用PX4神经网络控制技术让无人机自主巡检电力线路？
  • 告别网盘限速烦恼：开源下载助手LinkSwift让你的文件传输飞起来
  • 统一搜索与推荐：大语言模型时代的信息获取新探索
  • OpenCorePkg实战手册：构建稳定黑苹果引导的5个关键场景
  • 3步掌握Chrome图片格式转换：一键另存为JPG/PNG/WebP的终极指南
  • SSH 隧道实用指南：本地与远程端口转发全解析，助你成隧道高手！
  • 2026年小程序卖货平台搭建哪家好？适合商家的商城系统推荐
  • 2026年GEO优化系统源码二次开发，如何抢占流量新风口？
  • 深入解析musl libc的TLS初始化机制：从__init_tp到线程局部存储
  • 英雄联盟智能助手Seraphine：终极战绩查询与自动BP工具完全指南
  • 越华环保智能危废暂存库：三层数字化架构的落地实践
  • 极低温测量的“狙击手”：DABT-PT509高精度PT100采集卡与工业物联网接入实战
  • 网安小白入门科普！全方位讲解 CTF 网络安全赛事，手把手拆解赛制题型，零基础快速看懂 CTF 比赛
  • RxSwift：iOS 开发者的响应式编程工具箱
  • SSRF漏洞攻防全解析：从原理到RCE的完整攻击链
  • 真懂行老板看卡地亚机芯解析，专柜不说的那股子穴全拆开
  • 驻马店汽车贴膜排名前十揭秘：谁家贴车衣最靠谱？