gin框架学习-Gorm入门指南
目录
- 前言
- 一、GORM介绍
-
- 1、GORM概述
- 2、为什么选择GORM？
- 二、安装
- 三、快速入门
- 四、模型定义
-
- 1、模型定义介绍
- 2、约定
- 3、gorm.Model
- 4、高级选项
-
- 1）字段级权限控制
- 2）创建 / 更新时间追踪（纳秒、毫秒、秒、Time）
- 3）嵌入结构体
- 4）字段标签
- 5）关联标签
- 五、连接数据库
-
- 1、MySQL
-
- 1）自定义驱动
- 2）现有的数据库连接
- 3）GORM配置
- 2、连接池
前言
感谢开源项目gin-vue-admin，以及1010工作室的视频教程
本人学识尚浅，如有错误，请评论指出，谢谢！
详细可见个人博客：https://linzyblog.netlify.app/
一、GORM介绍
1、GORM概述
GORM一个目前比较热门的，使用简单，对开发人员友好的 Golang ORM 库。
GORM框架是go的一个数据库连接及交互框架，主要是把struct类型和数据库记录进行映射，数据库语句复杂的情况下可以直接手写语句，一般用于连接关系型数据库，这里我主要使用MySQL数据库。
对象关系映射（英语：Object Relational Mapping，简称ORM）： 通过使用描述对象和数据库之间映射的
元数据，将程序中的对象与关系数据库相互映射，可以使用面向对象的范例从数据库中查询和操作数据。
简而言之：代码结构即是数据库结构，代码行为就是数据库行为。
2、为什么选择GORM？
特性：
- 数据库连接(以MySQL为例)和自动建表方便。
- 文档内容详细全面，适合快速入门上手。
- 支持关联 (一对一，一对多，多对多的关系)。
- 带有Create，Save，Update，Delete，Find 中钩子方法。
- 支持
Preload、Joins的预加载，对于关联查询很重要，主要用于显示关联子结构的内容。 - 支持事务，嵌套事务。
- 可以使用Context、预编译模式、DryRun 模式。
- 批量插入，FindInBatches，Find/Create with Map，使用 SQL 表达式、Context Valuer 进行 CRUD。
- SQL 构建器，Upsert，
数据库锁，Optimizer/Index/Comment Hint，命名参数，子查询。 - 复合主键，索引，约束。
- 自定义 Logger。
- 灵活的可扩展插件 API：Database Resolver（多数据库，读写分离）、Prometheus…
- 开发者友好。
二、安装
GORM库github地址: https://github.com/go-gorm/gorm
GORM库文档地址：https://gorm.io/zh_CN/docs/
第一步：
很重要，go mod 包管理工具项目的开始都需要先做这一步
go mod init name
第二步：
操作MySQL数据库需要两个包
- GORM包
- MySQL驱动包
go get -u gorm.io/gorm
go get -u gorm.io/driver/mysql
或者：
你可以直接在文件里面直接导入这两个库的引用
import (
"gorm.io/driver/mysql"
"gorm.io/gorm"
)
再用 go mod tidy的方法自动导入库。
三、快速入门
package main
import (
"fmt"
"gorm.io/driver/mysql"
"gorm.io/gorm"
)
type User struct {
gorm.Model
Name string
Age uint
}
func main() {
//我这里用到数据库是mysql，需要配置DSN属性[username[:password]@][protocol[(address)]]/dbname[?param1=value1&...¶mN=valueN]
dsn := "root:123456@tcp(127.0.0.1:3306)/go_test?charset=utf8&parseTime=True"
db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
if err != nil {
panic("failed to connect database")
}
// 迁移 schema
db.AutoMigrate(&User{})
// Insert 插入语句
db.Create(&User{Name: "linzy", Age: 23})
// Select 查询语句
var user User
db.First(&user, 1) // 根据整形主键查找
fmt.Println(user)
db.First(&user, "name = ?", "linzy") // 查找 name 字段值为 linzy 的记录
fmt.Println(user)
// Update 更新语句 - 将 User 的 age 更新为 18
db.Model(&user).Update("Age", 18)
// Update - 更新多个字段
db.Model(&user).Updates(User{Name: "linzy", Age: 88}) // 仅更新非零值字段
db.Model(&user).Updates(map[string]interface{}{"Name": "linzy", "Age": 23})
// Delete 删除语句 - 删除 ID为1
db.Delete(&user, 1)
}
四、模型定义
GORM负责将对模型的读写操作翻译成sql语句，然后GORM再把数据库执行的sql语句后返回的结果转化为我们定义的模型对象。
1、模型定义介绍
模型是标准的 struct，由 Go 的基本数据类型、实现了 Scanner 和 Valuer 接口的自定义类型及其指针或别名组成。
例如：
type User struct {
ID uint
Name string
Email *string
Age uint8
Birthday *time.Time
MemberNumber sql.NullString
ActivedAt sql.NullTime
CreatedAt time.Time
UpdatedAt time.Time
}
默认gorm对struct字段名使用Snake Case命名风格转换成mysql表字段名(需要转换成小写字母)。
Snake Case命名风格，就是各个单词之间用下划线（_）分隔，首字母大写区分一个单词，例如： CreateTime的Snake Case风格命名为create_time
2、约定
GORM 倾向于约定，而不是配置。默认情况下，GORM 使用 ID 作为主键，使用结构体名的 蛇形复数 作为表名，字段名的 蛇形 作为列名，并使用 CreatedAt、UpdatedAt 字段追踪创建、更新时间
遵循 GORM 已有的约定，可以减少您的配置和代码量。如果约定不符合您的需求，GORM 允许您自定义配置它们
3、gorm.Model
GORM 定义一个 gorm.Model 结构体，其包括字段 ID、CreatedAt、UpdatedAt、DeletedAt
// gorm.Model 的定义
type Model struct {
ID uint `gorm:"primaryKey"` //设置主键
CreatedAt time.Time
UpdatedAt time.Time
DeletedAt gorm.DeletedAt `gorm:"index"`
}
可以将它嵌入到你的结构体中，以包含这几个字段
4、高级选项
1）字段级权限控制
可导出的字段在使用 GORM 进行 CRUD 时拥有全部的权限，此外，GORM 允许您用标签控制字段级别的权限。这样您就可以让一个字段的权限是只读、只写、只创建、只更新或者被忽略
注意： 使用 GORM Migrator 创建表时，不会创建被忽略的字段
type User struct {
Name string `gorm:"<-:create"` // 允许读和创建
Name string `gorm:"<-:update"` // 允许读和更新
Name string `gorm:"<-"` // 允许读和写（创建和更新）
Name string `gorm:"<-:false"` // 允许读，禁止写
Name string `gorm:"->"` // 只读（除非有自定义配置，否则禁止写）
Name string `gorm:"->;<-:create"` // 允许读和写
Name string `gorm:"->:false;<-:create"` // 仅创建（禁止从 db 读）
Name string `gorm:"-"` // 读写操作均会忽略该字段
}
2）创建 / 更新时间追踪（纳秒、毫秒、秒、Time）
GORM 约定使用 CreatedAt、UpdatedAt 追踪创建 / 更新时间。如果您定义了这种字段，GORM 在创建、更新时会自动填充 当前时间
要使用不同名称的字段，您可以配置 autoCreateTim、autoUpdateTim 标签
如果您想要保存 UNIX（毫 / 纳）秒时间戳，而不是 time，您只需简单地将 time.Time 修改为 int 即可
type User struct {
CreatedAt time.Time // 在创建时，如果该字段值为零值，则使用当前时间填充
UpdatedAt int // 在创建时该字段值为零值或者在更新时，使用当前时间戳秒数填充
Updated int64 `gorm:"autoUpdateTime:nano"` // 使用时间戳填纳秒数充更新时间
Updated int64 `gorm:"autoUpdateTime:milli"` // 使用时间戳毫秒数填充更新时间
Created int64 `gorm:"autoCreateTime"` // 使用时间戳秒数填充创建时间
}
3）嵌入结构体
对于匿名字段，GORM 会将其字段包含在父结构体中，例如：
type User struct {
gorm.Model
Name string
}
// 等效于
type User struct {
ID uint `gorm:"primaryKey"`
CreatedAt time.Time
UpdatedAt time.Time
DeletedAt gorm.DeletedAt `gorm:"index"`
Name string
}
对于正常的结构体字段，你也可以通过标签 embedded 将其嵌入，例如：
type Author struct {
Name string
Email string
}
type Blog struct {
ID int
Author Author `gorm:"embedded"`
Upvotes int32
}
// 等效于
type Blog struct {
ID int64
Name string
Email string
Upvotes int32
}
并且，您可以使用标签 embeddedPrefix 来为 db 中的字段名添加前缀，例如：
type Blog struct {
ID int
Author Author `gorm:"embedded;embeddedPrefix:author_"`
Upvotes int32
}
// 等效于
type Blog struct {
ID int64
AuthorName string
AuthorEmail string
Upvotes int32
}
4）字段标签
声明 model 时，tag 是可选的，GORM 支持以下 tag： tag 名大小写不敏感，但建议使用 camelCase 风格
| 标签名 | 说明 |
|---|---|
| column | 指定 db 列名 |
| type | 列数据类型，推荐使用兼容性好的通用类型，例如：所有数据库都支持 bool、int、uint、float、string、time、bytes 并且可以和其他标签一起使用，例如：not null、size, autoIncrement… 像 varbinary(8) 这样指定数据库数据类型也是支持的。在使用指定数据库数据类型时，它需要是完整的数据库数据类型，如：MEDIUMINT UNSIGNED not NULL AUTO_INSTREMENT |
| size | 指定列大小，例如：size:256 |
| primaryKey | 指定列为主键 |
| unique | 指定列为唯一 |
| default | 指定列的默认值 |
| precision | 指定列的精度 |
| scale | 指定列大小 |
| not null | 指定列为 NOT NULL |
| autoIncrement | 指定列为自动增长 |
| embedded | 嵌套字段 |
| embeddedPrefix | 嵌入字段的列名前缀 |
| autoCreateTime | 创建时追踪当前时间，对于 int 字段，它会追踪时间戳秒数，您可以使用 nano/milli 来追踪纳秒、毫秒时间戳，例如：autoCreateTime:nano |
| autoUpdateTime | 创建 / 更新时追踪当前时间，对于 int 字段，它会追踪时间戳秒数，您可以使用 nano/milli 来追踪纳秒、毫秒时间戳，例如：autoUpdateTime:milli |
| index | 根据参数创建索引，多个字段使用相同的名称则创建复合索引 |
| uniqueIndex | 与 index 相同，但创建的是唯一索引 |
| check | 创建检查约束，例如 check:age > 13 |
| <- | 设置字段写入的权限， <-:create 只创建、<-:update 只更新、<-:false 无写入权限、<- 创建和更新权限 |
| -> | 设置字段读的权限，->:false 无读权限 |
| - | 忽略该字段，- 无读写权限 |
5）关联标签
GORM 允许通过标签为关联配置外键、约束、many2many 表
五、连接数据库
GORM 官方支持的数据库类型有： MySQL, PostgreSQL, SQlite, SQL Server
1、MySQL
连接MySQL主要有两个步骤:
1）配置DSN (Data Source Name)
- DSN介绍：gorm库使用dsn作为连接数据库的参数，dsn翻译过来就叫数据源名称，用来描述数据库连接信息。一般都包含数据库连接地址，账号，密码之类的信息。
- DSN字段格式：
[username[:password]@][protocol[(address)]]/dbname[?param1=value1&…¶mN=valueN]
//mysql dsn格式
//涉及参数:
//username 数据库账号
//password 数据库密码
//host 数据库连接地址，可以是Ip或者域名
//port 数据库端口
//Dbname 数据库名
username:password@tcp(host:port)/Dbname?charset=utf8&parseTime=True&loc=Local
2）使用gorm.Open连接数据库
import (
"gorm.io/driver/mysql"
"gorm.io/gorm"
)
func main() {
// 参考 https://github.com/go-sql-driver/mysql#dsn-data-source-name 获取详情
dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
}
注意：想要正确的处理 time.Time ，您需要带上 parseTime 参数，要支持完整的 UTF-8 编码，您需要将 charset=utf8 更改为 charset=utf8mb4
MySQl 驱动程序提供了 一些高级配置 可以在初始化过程中使用，例如：
db, err := gorm.Open(mysql.New(mysql.Config{
// DSN data source name
DSN: "gorm:gorm@tcp(127.0.0.1:3306)/gorm?charset=utf8&parseTime=True&loc=Local",
// string 类型字段的默认长度
DefaultStringSize: 256,
// 禁用 datetime 精度，MySQL 5.6 之前的数据库不支持
DisableDatetimePrecision: true,
// 重命名索引时采用删除并新建的方式，MySQL 5.7 之前的数据库和 MariaDB 不支持重命名索引
DontSupportRenameIndex: true,
// 用 `change` 重命名列，MySQL 8 之前的数据库和 MariaDB 不支持重命名列
DontSupportRenameColumn: true,
// 根据当前 MySQL 版本自动配置
SkipInitializeWithVersion: false,
}), &gorm.Config{})
1）自定义驱动
GORM 允许通过 DriverName 选项自定义 MySQL 驱动，例如：
import (
"gorm.io/driver/mysql"
"gorm.io/gorm"
)
func main() {
db, err := gorm.Open(mysql.New(mysql.Config{
DriverName: "my_mysql_driver",
DSN: "gorm:gorm@tcp(localhost:9910)/gorm?charset=utf8&parseTime=True&loc=Local",
// Data Source Name，参考 https://github.com/go-sql-driver/mysql#dsn-data-source-name
}), &gorm.Config{})
}
2）现有的数据库连接
GORM 允许通过一个现有的数据库连接来初始化 *gorm.DB
import (
"database/sql"
"gorm.io/driver/mysql"
"gorm.io/gorm"
)
func main() {
sqlDB, err := sql.Open("mysql", "mydb_dsn")
gormDB, err := gorm.Open(mysql.New(mysql.Config{
Conn: sqlDB,
}), &gorm.Config{})
}
3）GORM配置
gorm.Config{}： GORM 提供可以在初始化时使用的配置。
type Config struct {
//跳过默认事务:为了确保数据一致性，GORM 会在事务里执行写入操作（创建、更新、删除）。
SkipDefaultTransaction bool
//命名策略:用户通过覆盖默认的NamingStrategy来更改命名约定
NamingStrategy schema.Namer
//Logger:通过覆盖此选项更改 GORM 的默认 logger
Logger logger.Interface
//NowFunc:更改创建时间使用的函数
NowFunc func() time.Time
//DryRun:生成 SQL 但不执行，可以用于准备或测试生成的 SQL
DryRun bool
//PrepareStmt:PreparedStmt 在执行任何 SQL 时都会创建一个 prepared statement 并将其缓存，以提高后续的效率
PrepareStmt bool
//禁用嵌套事务
DisableNestedTransaction bool
//AllowGlobalUpdate:启用全局 update/delete
AllowGlobalUpdate bool
//DisableAutomaticPing:在完成初始化后，GORM 会自动 ping 数据库以检查数据库的可用性
DisableAutomaticPing bool
//DisableForeignKeyConstraintWhenMigrating:在 AutoMigrate 或 CreateTable 时，GORM 会自动创建外键约束
DisableForeignKeyConstraintWhenMigrating bool
}
GORM配置详细内容直接看文档，我后续会再写一篇：点击跳转
2、连接池
在高并发实践中，为了提高数据库连接的使用率，避免重复建立数据库连接带来的性能消耗，会经常使用数据库连接池技术来维护数据库连接。
GORM 使用 database/sql 维护连接池
sqlDB, err := db.DB()
// SetMaxIdleConns 设置空闲连接池中连接的最大数量
sqlDB.SetMaxIdleConns(10)
// SetMaxOpenConns 设置打开数据库连接的最大数量。
sqlDB.SetMaxOpenConns(100)
// SetConnMaxLifetime 设置了连接可复用的最大时间。
sqlDB.SetConnMaxLifetime(time.Hour)
参考GORM中文文档:https://learnku.com/docs/gorm/v2/connecting_to_the_database/9731#64cea3