中文 | English
Gin-tonic 能够帮助研发人员快速构建Restful API，它可以将GORM的model暴露为CRUD handler.
快速开始
需要为model实现API访问相关的接口
/* 定义模型 */
type MyModel struct {
Name string `json:name`
Age uint `json:age`
Address string `json:address`
}
// 通过InsertableFields方法返回值定义可以插入的字段,例如返回 'age','name' 和 'address' 字段可以插入
func (f *Foo)InsertableFields() []string {
return []string{"age", "name", "address"}
}
// 通过UpdateableFields方法返回值定义可以更新的字段,例如返回 'age' 和 'address' 字段可更新
func (f *Foo)UpdateableFields() []string {
return []string{"age", "address"}
}
// 通过SortableFields方法返回值定义可以用于list接口参数指定排序的字段,例如返回 'age' 字段可用于排序
func (f *Foo)SortableFields() []string {
return []string{"age"}
}
// 通过FilterableFields方法返回值定义可以用于list接口参数过滤字段白名单,例如返回 'age' 字段可用于筛选
func (f *Foo)FilterableFields() []string {
return []string{"age", "name", "address"}
}列表接口示例
import (
"github.com/webliupeng/gin-tonic/helpers"
)
router.Get("/models", helpers.List(&MyModel{}))
// 也可以自己定义gorm的查询条件
router.Get("/models2", helpers.List(&MyModel{}, func(db *gorm.DB, c *gin.Context) {
return db.Where("file", "=", 321)
}))gin-tonic 生成的list handler默认支持排序，过滤，分页。
querystring参数表达式：
| 表达式 | 用法 |
|---|---|
| > | field_gt=val |
| >= | field_gte=val |
| < | field_lt=val |
| <= | field_lte=val |
| like | field_like=val |
| in | field_in=val1,val2,valn |
| not in | field_not=val1,val2,valn |
分页参数：
| 表达式 | 用法 |
|---|---|
| .maxResults | 最大返回记录数 |
| .offset | 记录起始位置 |
curl https://hostname/models?.maxResults=100&.offset=10 # equals LIMIT 10, 100
curl https://hostname/models?age_lt=10 #list custerms filtered by age less than 10
curl https://hostname/models?age=10创建记录处理器示例
创建处理器会通过gin的ShouldBindBodyWith解析请求body，如果model定义了validator的规则，将会校验请求的数据，通过才会插入数据库。
router.Post("/models", helpers.Create(func(c *gin.Context) interface{} {
mol := &Models{}
// 可以在这里设定默认值
return mol
}))curl --header "Content-Type: application/json" \
--request POST \
--data '{"name": "a"}' \
https://yourdomain/models
更新处理器示例 更新处理器会通过gin的ShouldBindBodyWith解析请求body，如果model定义了validator的规则，将会校验请求的数据，通过才会更新入数据库。
router.Put("/models/:id",
helpers.FindOne(&MyModel{}, "id", "mymodel"), // 通过 id 参数查询一条MyModel的记录，并将结果暂存在context
helpers.Update("customer") // 更新mymodel
)删除处理器示例
router.Delete("/models/:id",
helpers.FindOne(&Customer{}, "id", "customer"), // 通过 id 参数查询一条MyModel的记录，并将结果暂存在context
helpers.Delete("customer") // delete the record by context name
)配置
- Gin-tonic是通过Viper 来读取配置的
gin-tonic，推荐使用以下环境变量来配置数据库。
export GTC_DB_HOST=localhost
export GTC_DB_NAME=dbname
export GTC_DB_PORT=3306
export GTC_DB_USER=username
export GTC_DB_PASSWORD=password