SuperAPI AI 工具集

go-chi-handler

通用与其它

查看项目

更新于 10-15 20:29

技能介绍

用途:为 Go 后端生成基于 Chi 路由的 HTTP 处理器实现,适用于 REST 端点处理器或 Web HTTP 处理器,包括 List、Create、Update、Delete、Get 等操作,以及请求/响应 DTO 映射与用例编排、Swagger 注解端点。

主要能力:生成处理器结构体(含各用例、response.ErrorHandler、logger.Logger),构造函数返回 *ResourceHandler;DTO 定义在 internal/modules/<module>/http/dto/<resource>_dto.go,使用 JSON 标签;处理器方法统一以 Handle 前缀命名;用例统一使用 ucdecorator.UseCase[Input, Output] 泛型接口;通过 request.ReadJSON 解码请求,response.JSON 与 response.NoContent 输出响应;路径参数通过私有方法 parseUintPathParam 结合 chi.URLParam 与 strconv.ParseUint 解析;每个方法需完整 Swagger 注解,@Failure 使用 brickserrs.Error;错误处理统一先 h.logger.Error 再 h.errorHandler.Error 后 return;Fx 装配使用 fx.Provide(handler.NewResourceHandler)。

使用方式:按资料中的目录结构与命名约定生成代码,生成后运行 make lint 和 make update-swagger。

限制:禁止在处理器文件中添加包级独立函数,所有辅助逻辑须为结构体私有方法;禁止直接使用 w.WriteHeader 代替 response.NoContent;错误须定义在模块 errs/ 包中,不得在方法体内内联 brickserrs.New 硬编码错误码;不得在方法体内添加冗余注释;不得直接返回用例输出,须映射为 DTO。资料未提供安装命令、收费与平台信息。