基于gin的golang web开发：访问mysql数据库
web开发基本都离不开访问数据库，在Gin中使用mysql数据库需要依赖mysql的驱动。直接使用驱动提供的API就要写很多样板代码。你可以找到很多扩展包这里介绍的是jmoiron/sqlx。另外还有一个用来处理空值的包guregu/null。
go get github.com/go-sql-driver/mysql
go get gopkg.in/guregu/null.v4
go get github.com/jmoiron/sqlx
连接数据库
jmoiron/sqlx包为database/sql提供了很多扩展方法，例如Select可以直接把查询结果映射为结构体，不在需要对每一列进行绑定。使用jmoiron/sqlx连接数据库的方法和mysql驱动提供的方法是一样的，可以直接调用sqlx.Connect并传入连接字符串。这里使用go语言init机制初始化数据库连接。
package db
import (
_ "github.com/go-sql-driver/mysql"
"github.com/jmoiron/sqlx"
"log"
)
var Db *sqlx.DB
func init() {
db, err := sqlx.Connect("mysql", "...?parseTime=true")
if err != nil {
log.Panicln("db err: ", err.Error())
}
db.SetMaxOpenConns(20)
db.SetMaxIdleConns(20)
Db = db
}
连接字符串中设置parseTime=true是为了解析mysql中日期时间类型。
type SysRole struct {
Id int64 `json:"id"`
Name sql.NullString `json:"name"` // 角色名
Description sql.NullString `json:"description"`
Available sql.NullInt32 `json:"available"`
CreateTime sql.NullTime `json:"create_time" db:"create_time"` // 添加时间
UpdateTime sql.NullTime `json:"update_time" db:"update_time"` // 更新时间
}
func main() {
r := gin.Default()
r.GET("/test", func(c *gin.Context) {
var sysRole []SysRole
dataSql := `
select id, name, description, available, create_time, update_time
from sys_role
`
err := db.Db.Select(&sysRole, dataSql)
if err != nil {
panic(`select sys_role err: ` + err.Error())
}
c.JSON(200, gin.H{
"data": sysRole,
})
})
r.Run(":9001")
}
在go语言中int、string之类的类型是不可以为空的，sql.NullXXX类型代表了数据库中的可空类型。还要注意一下CreateTime字段的标签，如果表的列名和结构体字段名不一样的话就要添加db标签db:"create_time"。
访问一下接口你会发现结果可能并不是你想要的，每一个可空类型的字段都变成了对象。
{
"data": [
{
"id": 1,
"name": {
"String": "role:root",
"Valid": true
},
"description": {
"String": "超级管理员",
"Valid": true
},
"available": {
"Int32": 1,
"Valid": true
},
"create_time": {
"Time": "2020-10-25T03:13:12Z",
"Valid": true
},
"update_time": {
"Time": "2020-10-25T03:13:12Z",
"Valid": true
}
}
...
]
}
解决空值的问题
使用guregu/null包可以解决空值的问题，guregu/null为数据库和JSON提供了可空的数据类型，可以替换掉所有sql.NullXXX类型。更新后的结构体如下：
type SysRole struct {
Id int64 `json:"id"`
Name null.String `json:"name"` // 角色名
Description null.String `json:"description"`
Available null.Int `json:"available"`
CreateTime null.Time `json:"create_time" db:"create_time"` // 添加时间
UpdateTime null.Time `json:"update_time" db:"update_time"` // 更新时间
}
再次访问接口会看到熟悉的JSON结果，并且当数据为空时也能返回正确的值。
{
"data": [
{
"id": 1,
"name": "role:root",
"description": "超级管理员",
"available": 1,
"create_time": "2020-10-25T03:13:12Z",
"update_time": null
},
...
]
}
