package {{.Package}} import ( {{if not .OnlyTemplate}} "{{.Module}}/global" "{{.Module}}/model/common/response" "{{.Module}}/model/{{.Package}}" {{- if not .IsTree}} {{.Package}}Req "{{.Module}}/model/{{.Package}}/request" {{- end }} "github.com/gin-gonic/gin" "go.uber.org/zap" {{- if .AutoCreateResource}} "{{.Module}}/utils" {{- end }} {{- else}} "{{.Module}}/model/common/response" "github.com/gin-gonic/gin" {{- end}} ) type {{.StructName}}Api struct {} {{if not .OnlyTemplate}} // Create{{.StructName}} 创建{{.Description}} // @Tags {{.StructName}} // @Summary 创建{{.Description}} // @Security ApiKeyAuth // @Accept application/json // @Produce application/json // @Param data body {{.Package}}.{{.StructName}} true "创建{{.Description}}" // @Success 200 {object} response.Response{msg=string} "创建成功" // @Router /{{.Abbreviation}}/create{{.StructName}} [post] func ({{.Abbreviation}}Api *{{.StructName}}Api) Create{{.StructName}}(c *gin.Context) { // 创建业务用Context ctx := c.Request.Context() var {{.Abbreviation}} {{.Package}}.{{.StructName}} err := c.ShouldBindJSON(&{{.Abbreviation}}) if err != nil { response.FailWithMessage(err.Error(), c) return } {{- if .AutoCreateResource }} {{.Abbreviation}}.CreatedBy = utils.GetUserID(c) {{- end }} err = {{.Abbreviation}}Service.Create{{.StructName}}(ctx,&{{.Abbreviation}}) if err != nil { global.GVA_LOG.Error("创建失败!", zap.Error(err)) response.FailWithMessage("创建失败:" + err.Error(), c) return } response.OkWithMessage("创建成功", c) } // Delete{{.StructName}} 删除{{.Description}} // @Tags {{.StructName}} // @Summary 删除{{.Description}} // @Security ApiKeyAuth // @Accept application/json // @Produce application/json // @Param data body {{.Package}}.{{.StructName}} true "删除{{.Description}}" // @Success 200 {object} response.Response{msg=string} "删除成功" // @Router /{{.Abbreviation}}/delete{{.StructName}} [delete] func ({{.Abbreviation}}Api *{{.StructName}}Api) Delete{{.StructName}}(c *gin.Context) { // 创建业务用Context ctx := c.Request.Context() {{.PrimaryField.FieldJson}} := c.Query("{{.PrimaryField.FieldJson}}") {{- if .AutoCreateResource }} userID := utils.GetUserID(c) {{- end }} err := {{.Abbreviation}}Service.Delete{{.StructName}}(ctx,{{.PrimaryField.FieldJson}} {{- if .AutoCreateResource -}},userID{{- end -}}) if err != nil { global.GVA_LOG.Error("删除失败!", zap.Error(err)) response.FailWithMessage("删除失败:" + err.Error(), c) return } response.OkWithMessage("删除成功", c) } // Delete{{.StructName}}ByIds 批量删除{{.Description}} // @Tags {{.StructName}} // @Summary 批量删除{{.Description}} // @Security ApiKeyAuth // @Accept application/json // @Produce application/json // @Success 200 {object} response.Response{msg=string} "批量删除成功" // @Router /{{.Abbreviation}}/delete{{.StructName}}ByIds [delete] func ({{.Abbreviation}}Api *{{.StructName}}Api) Delete{{.StructName}}ByIds(c *gin.Context) { // 创建业务用Context ctx := c.Request.Context() {{.PrimaryField.FieldJson}}s := c.QueryArray("{{.PrimaryField.FieldJson}}s[]") {{- if .AutoCreateResource }} userID := utils.GetUserID(c) {{- end }} err := {{.Abbreviation}}Service.Delete{{.StructName}}ByIds(ctx,{{.PrimaryField.FieldJson}}s{{- if .AutoCreateResource }},userID{{- end }}) if err != nil { global.GVA_LOG.Error("批量删除失败!", zap.Error(err)) response.FailWithMessage("批量删除失败:" + err.Error(), c) return } response.OkWithMessage("批量删除成功", c) } // Update{{.StructName}} 更新{{.Description}} // @Tags {{.StructName}} // @Summary 更新{{.Description}} // @Security ApiKeyAuth // @Accept application/json // @Produce application/json // @Param data body {{.Package}}.{{.StructName}} true "更新{{.Description}}" // @Success 200 {object} response.Response{msg=string} "更新成功" // @Router /{{.Abbreviation}}/update{{.StructName}} [put] func ({{.Abbreviation}}Api *{{.StructName}}Api) Update{{.StructName}}(c *gin.Context) { // 从ctx获取标准context进行业务行为 ctx := c.Request.Context() var {{.Abbreviation}} {{.Package}}.{{.StructName}} err := c.ShouldBindJSON(&{{.Abbreviation}}) if err != nil { response.FailWithMessage(err.Error(), c) return } {{- if .AutoCreateResource }} {{.Abbreviation}}.UpdatedBy = utils.GetUserID(c) {{- end }} err = {{.Abbreviation}}Service.Update{{.StructName}}(ctx,{{.Abbreviation}}) if err != nil { global.GVA_LOG.Error("更新失败!", zap.Error(err)) response.FailWithMessage("更新失败:" + err.Error(), c) return } response.OkWithMessage("更新成功", c) } // Find{{.StructName}} 用id查询{{.Description}} // @Tags {{.StructName}} // @Summary 用id查询{{.Description}} // @Security ApiKeyAuth // @Accept application/json // @Produce application/json // @Param {{.PrimaryField.FieldJson}} query {{.PrimaryField.FieldType}} true "用id查询{{.Description}}" // @Success 200 {object} response.Response{data={{.Package}}.{{.StructName}},msg=string} "查询成功" // @Router /{{.Abbreviation}}/find{{.StructName}} [get] func ({{.Abbreviation}}Api *{{.StructName}}Api) Find{{.StructName}}(c *gin.Context) { // 创建业务用Context ctx := c.Request.Context() {{.PrimaryField.FieldJson}} := c.Query("{{.PrimaryField.FieldJson}}") re{{.Abbreviation}}, err := {{.Abbreviation}}Service.Get{{.StructName}}(ctx,{{.PrimaryField.FieldJson}}) if err != nil { global.GVA_LOG.Error("查询失败!", zap.Error(err)) response.FailWithMessage("查询失败:" + err.Error(), c) return } response.OkWithData(re{{.Abbreviation}}, c) } {{- if .IsTree }} // Get{{.StructName}}List 分页获取{{.Description}}列表,Tree模式下不接受参数 // @Tags {{.StructName}} // @Summary 分页获取{{.Description}}列表 // @Security ApiKeyAuth // @Accept application/json // @Produce application/json // @Success 200 {object} response.Response{data=response.PageResult,msg=string} "获取成功" // @Router /{{.Abbreviation}}/get{{.StructName}}List [get] func ({{.Abbreviation}}Api *{{.StructName}}Api) Get{{.StructName}}List(c *gin.Context) { // 创建业务用Context ctx := c.Request.Context() list, err := {{.Abbreviation}}Service.Get{{.StructName}}InfoList(ctx) if err != nil { global.GVA_LOG.Error("获取失败!", zap.Error(err)) response.FailWithMessage("获取失败:" + err.Error(), c) return } response.OkWithDetailed(list, "获取成功", c) } {{- else }} // Get{{.StructName}}List 分页获取{{.Description}}列表 // @Tags {{.StructName}} // @Summary 分页获取{{.Description}}列表 // @Security ApiKeyAuth // @Accept application/json // @Produce application/json // @Param data query {{.Package}}Req.{{.StructName}}Search true "分页获取{{.Description}}列表" // @Success 200 {object} response.Response{data=response.PageResult,msg=string} "获取成功" // @Router /{{.Abbreviation}}/get{{.StructName}}List [get] func ({{.Abbreviation}}Api *{{.StructName}}Api) Get{{.StructName}}List(c *gin.Context) { // 创建业务用Context ctx := c.Request.Context() var pageInfo {{.Package}}Req.{{.StructName}}Search err := c.ShouldBindQuery(&pageInfo) if err != nil { response.FailWithMessage(err.Error(), c) return } list, total, err := {{.Abbreviation}}Service.Get{{.StructName}}InfoList(ctx,pageInfo) if err != nil { global.GVA_LOG.Error("获取失败!", zap.Error(err)) response.FailWithMessage("获取失败:" + err.Error(), c) return } response.OkWithDetailed(response.PageResult{ List: list, Total: total, Page: pageInfo.Page, PageSize: pageInfo.PageSize, }, "获取成功", c) } {{- end }} {{- if .HasDataSource }} // Get{{.StructName}}DataSource 获取{{.StructName}}的数据源 // @Tags {{.StructName}} // @Summary 获取{{.StructName}}的数据源 // @Accept application/json // @Produce application/json // @Success 200 {object} response.Response{data=object,msg=string} "查询成功" // @Router /{{.Abbreviation}}/get{{.StructName}}DataSource [get] func ({{.Abbreviation}}Api *{{.StructName}}Api) Get{{.StructName}}DataSource(c *gin.Context) { // 创建业务用Context ctx := c.Request.Context() // 此接口为获取数据源定义的数据 dataSource, err := {{.Abbreviation}}Service.Get{{.StructName}}DataSource(ctx) if err != nil { global.GVA_LOG.Error("查询失败!", zap.Error(err)) response.FailWithMessage("查询失败:" + err.Error(), c) return } response.OkWithData(dataSource, c) } {{- end }} {{- end }} // Get{{.StructName}}Public 不需要鉴权的{{.Description}}接口 // @Tags {{.StructName}} // @Summary 不需要鉴权的{{.Description}}接口 // @Accept application/json // @Produce application/json // @Success 200 {object} response.Response{data=object,msg=string} "获取成功" // @Router /{{.Abbreviation}}/get{{.StructName}}Public [get] func ({{.Abbreviation}}Api *{{.StructName}}Api) Get{{.StructName}}Public(c *gin.Context) { // 创建业务用Context ctx := c.Request.Context() // 此接口不需要鉴权 // 示例为返回了一个固定的消息接口,一般本接口用于C端服务,需要自己实现业务逻辑 {{.Abbreviation}}Service.Get{{.StructName}}Public(ctx) response.OkWithDetailed(gin.H{ "info": "不需要鉴权的{{.Description}}接口信息", }, "获取成功", c) }