【Gin】Gin 使用 GORM 操作 MySQL 数据库
文章目录
-
- GORM
-
- ⭐️GORM 介绍
- ⭐️Gin 当中使用 GORM
- ⭐️CRUD
- ⭐️查询语句详解
- ⭐️查看执行的 sql 语句
作者的 Gin 框架学习是根据 B站视频 Gin教程_Golang框架Gin入门实战教程 来学习的，对大地老师的评价不吹不捧，很喜欢其讲课风格，而且这个视频特别适合小白学习，强烈推荐。
GORM
⭐️GORM 介绍
官网：https://gorm.io/
GORM 是Golang 的一个 orm 框架。ORM 就是通过实例对象的语法，完成关系数据库的操作的技术，是“对象-关系映射”（Object-Relational Mapping）的缩写。使用 orm 框架可以让我们更方便的操作数据库。
GORM 支持的数据库类型有：MySQL、PostgreSQL、SQlite、SQL Server
特性(摘自官网)
- 全功能 ORM
- 关联 (Has One，Has Many，Belongs To，Many To Many，多态，单表继承)
- Create，Save，Update，Delete，Find 中钩子方法
- 支持
Preload、Joins的预加载 - 事务，嵌套事务，Save Point，Rollback To Saved Point
- Context、预编译模式、DryRun 模式
- 批量插入，FindInBatches，Find/Create with Map，使用 SQL 表达式、Context Valuer 进行 CRUD
- SQL 构建器，Upsert，数据库锁，Optimizer/Index/Comment Hint，命名参数，子查询
- 复合主键，索引，约束
- Auto Migration
- 自定义 Logger
- 灵活的可扩展插件 API：Database Resolver（多数据库，读写分离）、Prometheus…
- 每个特性都经过了测试的重重考验
- 开发者友好
⭐️Gin 当中使用 GORM
1、安装
如果使用 go mod 管理项目的话可以忽略此步骤
go get -u gorm.io/gorm
go get -u gorm.io/driver/mysql
2、Gin 当中使用 GORM 连接数据库
在 models 下新建 core.go 建立数据库连接
package models
import (
"fmt"
"gorm.io/driver/mysql"
"gorm.io/gorm"
)
var DB *gorm.DB
var err error
func init() {
// 参考 https://github.com/go-sql-driver/mysql#dsn-data-source-name 获取详情
dsn := "root:123456@tcp(127.0.0.1:3306)/gin?charset=utf8mb4&parseTime=True&loc=Local"
DB, err = gorm.Open(mysql.Open(dsn), &gorm.Config{})
if err != nil {
fmt.Println(err)
}
}
3、定义操作数据库的模型（相当于 Java 当中的实体类）
定义数据库模型注意以下几点：
1、结构体的名称必须首字母大写。并和数据库表名称对应。例如：表名称为 user 结构体名称定义为 User，表名称为 article_cate 的结构体名称定义为 ArticleCate。
2、结构体当中的字段名称首字母必须大写。并和数据库表中的字段一一对应。例如：下面结构体中的 Id 和数据库中的 id 对应，Username 和数据库中的 username 对应，Age 和数据库中的 age 对应，Email 和数据库中的 email 对应，AddTime 和数据库中的 add_time 字段对应。
3、默认情况表名是结构体名称的复数形式。如果我们的结构体名称定义为 User ，表示这个模型默认操作的是 users 表。
4、我们可以使用结构体中的自定义方法 TableName 改变结构体的默认表名称
func (user User) TableName() string{
return "user"
}
定义 user 模型
package models
type User struct {
Id int
Username string
Age int
Email string
AddTime int
}
// TableName 表示配置操作数据库的表名称
func (user User) TableName() string {
return "user"
}
⭐️CRUD
找到要操作数据库表的控制器,然后引入 models 模块
package admin
import (
"Gin_demo/models"
"fmt"
"github.com/gin-gonic/gin"
"net/http"
"path"
)
type UserController struct {
BaseController
}
func (con UserController) Index(c *gin.Context) {
// 查询数据库
/*userList := []models.User{}
models.DB.Find(&userList)
c.JSON(http.StatusOK, gin.H{
"result": userList,
})*/
// 查询年龄大于20的用户
userList := []models.User{}
models.DB.Where("age>20").Find(&userList)
c.JSON(http.StatusOK, gin.H{
"result": userList,
})
}
func (con UserController) Add(c *gin.Context) {
user := models.User{
Username: "zhaoliu",
Age: 25,
Email: "[email protected]",
AddTime: int(models.GetUnix()),
}
models.DB.Create(&user)
c.String(http.StatusOK, "增加数据成功!")
fmt.Println("user==>", user)
}
func (con UserController) Edit(c *gin.Context) {
// 保存所有字段
// 查询 id 等于 6 的数据
/*user := models.User{
Id: 1,
}
models.DB.Find(&user)
user.Username = "haha"
user.Age = 11
user.AddTime = int(models.GetUnix())
models.DB.Save(&user)*/
/*user := models.User{}
models.DB.Model(&user).Where("id=?", 1).Update("username", "hahahaha")*/
user := models.User{}
models.DB.Where("id=?", 1).Find(&user)
user.Username = "haha"
user.AddTime = int(models.GetUnix())
models.DB.Save(&user)
c.JSON(http.StatusOK, gin.H{
"result": user,
})
}
func (con UserController) Delete(c *gin.Context) {
/*user := models.User{
Id: 3,
}
models.DB.Delete(&user)*/
user := models.User{}
models.DB.Where("id=?", 4).Delete(&user)
c.String(200, "删除成功")
}
⭐️查询语句详解
https://gorm.io/zh_CN/docs/query.html
package admin
import (
"Gin_demo/models"
"github.com/gin-gonic/gin"
)
type NavJSON struct {
Id int `json:"id"`
Title string `json:"title"`
}
type NavController struct {
BaseController
}
func (j NavJSON) TableName() string {
return "nav"
}
func (con NavController) Index(c *gin.Context) {
// 查询全部数据
/*navList := []models.Nav{}
models.DB.Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// 查询单条数据
/*nav := models.Nav{Id: 2}
models.DB.Find(&nav)
c.JSON(200, gin.H{
"result": nav,
})*/
// 查询id大于3的数据
/*navList := []models.Nav{}
models.DB.Where("id>?", 3).Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// 查询id大于3 AND id小于6的数据
/*var a = 3
var b = 6
navList := []models.Nav{}
models.DB.Where("id > ? and id < ?", a, b).Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// 使用in 查询id 在 3 5 6 当中的数据
/*navList := []models.Nav{}
models.DB.Where("id in(?)", []int{3, 5, 6}).Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// like
/*navList := []models.Nav{}
models.DB.Where("title like ?", "%你%").Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// between and
/*navList := []models.Nav{}
models.DB.Where("id between ? and ?", 3, 6).Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// Or
/*navList := []models.Nav{}
models.DB.Where("id = ? or id = ?", 3, 6).Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
/*navList := []models.Nav{}
models.DB.Where("id = ? ", 3).Or("id = ?", 6).Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// 使用 Select 指定返回的字段
/*navList := []models.Nav{}
models.DB.Select("id,title").Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
/*navList := []NavJSON{}
models.DB.Select("id,title").Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// 排序
/*navList := []models.Nav{}
models.DB.Order("id desc").Order("sort asc").Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
/*navList := []models.Nav{}
models.DB.Order("id desc").Order("sort asc").Limit(2).Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// 分页
/*navList := []models.Nav{}
models.DB.Order("id desc").Offset(2).Limit(2).Find(&navList)
c.JSON(200, gin.H{
"result": navList,
})*/
// Count
navList := []models.Nav{}
var num int64
models.DB.Find(&navList).Count(&num)
c.JSON(200, gin.H{
"result": num,
})
}
⭐️查看执行的 sql 语句
package models
import (
"fmt"
"gorm.io/driver/mysql"
"gorm.io/gorm"
"gorm.io/gorm/logger"
"gorm.io/gorm/schema"
)
var DB *gorm.DB
var err error
func init() {
// 参考 https://github.com/go-sql-driver/mysql#dsn-data-source-name 获取详情
dsn := "root:123456@tcp(127.0.0.1:3306)/gin?charset=utf8mb4&parseTime=True&loc=Local"
DB, err = gorm.Open(mysql.Open(dsn), &gorm.Config{
Logger: logger.Default.LogMode(logger.Info),
NamingStrategy: schema.NamingStrategy{
SingularTable: true,
},
})
if err != nil {
fmt.Println(err)
}
}