GinSkeleton：从零开始一款基于GoLang开发的Web后端框架

在/app/http/model中创建category/category.go文件

/**
 * @note:
 * @author: zhangruiyuan
 * @date:2021/7/6
**/
package category

import (
	"go.uber.org/zap"
	"goskeleton/app/global/variable"
	"goskeleton/app/model"
)

func CreatCategoryFactory(sqlType string) * CategoryModel {
	return &CategoryModel{BaseModel:model.BaseModel{DB:model.UseDbConn(sqlType)}}
}

type CategoryModel struct {
	model.BaseModel
	Id  uint `json:"id"`
	Name string `json:"name"`
	Description string `json:"description"`
	File string `json:"file"`
}

// 需要返回给前端的数据，建议在同文件夹下建一个`data_type.go`的文件
type CategoryView struct {
	Id  uint `json:"id"`
	Name string `json:"name"`
	Description string `json:"description"`
	File string `json:"file"`
}

// 表名
func (c * CategoryModel) TableName() string {
	return "tb_category"
}


// 查询列表
func (c * CategoryModel) List(limitStart,limit int) (list []CategoryView) {

	sql := `
		select * from tb_category limit ? , ?;
	`
	if res := c.Raw(sql, limitStart, limit).Find(&list); res.Error != nil{
		variable.ZapLog.Error("CategoryModel 查询出错", zap.Error(res.Error))
	}
	return
}

在/app/http/controller中创建category/category.go文件

/**
 * @note:
 * @author: zhangruiyuan
 * @date:2021/7/6
**/
package category

import (
	"fmt"
	"github.com/gin-gonic/gin"
	"goskeleton/app/global/consts"
	"goskeleton/app/global/variable"
	"goskeleton/app/model/category"
	"goskeleton/app/utils/response"
)

type Category struct {
	Id           uint          `json:"id"`
	Name         string        `json:"name"`
	Description  string        `json:"description"`
	File         string        `json:"file"`
}

// 添加一项
func (c *Category) AddCategory(context *gin.Context) {
	c.Id = uint(variable.SnowFlake.GetId())
	response.Success(context, "验信息", c)
}

// 获取分类列表
func (c *Category) List(context *gin.Context)  {
	var limit = context.GetFloat64(consts.ValidatorPrefix + "limit")
	var limitStart = (context.GetFloat64(consts.ValidatorPrefix+"page") - 1) * limit
	fmt.Println(limit,limitStart)
	list := category.CreatCategoryFactory("").List(int(limitStart),int(limit))
	if list != nil{
		response.Success(context, consts.CurdStatusOkMsg, gin.H{
			"data": list,
		})
	}else {
		response.Fail(context,consts.CurdSelectFailCode, consts.CurdSelectFailMsg,"")
	}
}

在/app/http/validator/web中创建category/list.go文件

/**
 * @note:
 * @author: zhangruiyuan
 * @date:2021/7/6
**/
package category

import (
	"github.com/gin-gonic/gin"
	"goskeleton/app/global/consts"
	"goskeleton/app/http/controller/category"
	"goskeleton/app/http/validator/core/data_transfer"
	"goskeleton/app/http/validator/web/auth/common_data_type"
	"goskeleton/app/utils/response"
)

type List struct {
	common_data_type.Page
}

// 验证器语法
func (l List) CheckParams(context *gin.Context)  {
	// 1. 基本的验证规则
	if err := context.ShouldBind(&l); err!=nil{
		errs := gin.H{
			"tips": "category 参数校验失败，参数不符合规定，page的值(>0)、limits的值(>0)",
			"err": err.Error(),
		}
		response.ErrorParam(context,errs)
		return
	}

	// 该函数的主要作用是将本结构体的字段（成员）按照consts.ValidatorPrefix + json 标签对应的 键 => 值 形式直接传递给下一步 （控制器）
	extraAddBindDataContext := data_transfer.DataAddContext(l,consts.ValidatorPrefix,context)
	if extraAddBindDataContext == nil {
		response.ErrorSystem(context, "category 表单验证器json化失败", "")
	} else {
		//验证完成，调用控制器，并将验证器成员（字段）递给控制器，保持上下文数据一致性
		(&category.Category{}).List(extraAddBindDataContext)
	}
}

在/app/http/validator/common/register_validator/web_register_validator.go中注册验证器

引用包为goskeleton/app/http/validator/web/category

// 「测试注册」任务分类管理
{
  key = consts.ValidatorPrefix + "CategoryList"
  containers.Set(key,category.List{})
}

在/routers/web.go中「后端接口路由」中添加「获取分类列表的路由」

// 「我的测试」获取分类列表
backend.GET("category", validatorFactory.Create(consts.ValidatorPrefix+"CategoryList") )

启动cmd/web/main.go

在浏览器测试下述网站

http://127.0.0.1:20201/admin/category?page=1&limit=3
http://127.0.0.1:20201/admin/category?page=1&limit=6
http://127.0.0.1:20201/admin/category?page=2&limit=3
http://127.0.0.1:20201/admin/category?page=2&limit=10

测试效果如下

感谢GinSkeleton作者张奇峰提供的框架。张馆长建了一个QQ群273078549，答疑很及时，十分感谢。

[1] https://gitee.com/daitougege/GinSkeleton
[2] https://gitee.com/daitougege/gin-skeleton-admin-backend