人生苦短，let’s Go.
ORM 框架ORM：Object Relational Mapping —— 对象关系映射。
作用：
-
通过操作结构体对象，来达到操作数据库表的目的。
-
通过结构体对象，来生成数据库表。
优点：
-
SQL有可能 比较复杂。（
Oracle--- 子查询 -- 嵌套）ORM操作数据库，不需要使用SQL -
不同开发者，书写的
SQL语句执行效率不同。
go语言支持的 ORM：gORM , xORM
[连接数据库]
import ( "github.com/jinzhu/gorm" _ "github.com/go-sql-driver/mysql" //"_" 代码不直接使用包, 底层链接要使用! "fmt" ) // mysql: 数据库的驱动名 // 链接数据库 --格式: 用户名:密码@协议(IP:port)/数据库名？xxx&yyy& conn, err := gorm.Open("mysql", "root:123456@tcp(127.0.0.1:3306)/test") if err != nil { fmt.Println("gorm.Open err:",err) return } defer conn.Close()
创建数据库表。—— 不能使用gorm创建数据库。 提前使用 SQL语句，创建好想要的数据库。AutoMigrate() 创建表。默认创建的表为复数类型。—— 自动添加“s”
在创建之前， 添加 conn.SingularTable(true) 可以创建非复数表名的表。
// 不要复数表名 conn.SingularTable(true) // 借助 gorm 创建数据库表. fmt.Println(conn.AutoMigrate(new(Student)).Error)
MySQL 包的 init 方法
_ "github.com/go-sql-driver/mysql" 导入包时， “_” ,表示，驱使go系统，在main() 函数被调用之前，自动调用 init() 函数。
go语言中有两个特殊函数： —— 首字母小写，包外可见
-
main() —— 项目的入口函数
-
init() —— 当导包，但没有在程序中使用。在main() 调用之前，自动被调用。
查看：光标置于 MySQL包的 “mysql” 上。使用 Ctrl-鼠标左键。看到源码。在 driver.go 底部包含 init() 函数的 定义。init() 作用：实现注册 MySQL 驱动。
gorm的连接池
-- 默认，gorm框架创建好的MySQL数据库连接 conn ，就是一个连接池的句柄。conn, err := gorm.Open("mysql", "root:123456@tcp(127.0.0.1:3306)/test")
初始化全局变量， 接收句柄
// 创建全局连接池句柄 var GlobalConn *gorm.DB GlobalConn = conn
db.LogMode(false) 是否打印执行SQL
修改连接池初始属性
// 初始数 GlobalConn.DB().SetMaxIdleConns(10) // 最大数 GlobalConn.DB().SetMaxOpenConns(100)
使用连接池句柄
--- 对比redis连接池：不需要使用 Get() 方法，取一条连接。
// 不要复数表名 GlobalConn.SingularTable(true) // 借助 gorm 创建数据库表. fmt.Println(GlobalConn.AutoMigrate(new(Student)).Error)
MySQL 8小时 时区问题
MySQL默认使用的时间 ：美国 东 8 区 时间 。—— 北京时间 —— 差 8 小时。
在连接数据库时，添加属性：?parseTime=True&loc=Local
conn, err := gorm.Open("mysql”,"root:123456@tcp(127.0.0.1:3306)/test?parseTime=True&loc=Local")
再执行SQL语句、gorm访问MySQL 使用 北京时间。
[SQL操作]
插入:
// insert into student(name, age) values('zhangsan', 100) func InsertData() { // 先创建数据 --- 创建对象 var stu Student stu.Name = "zhangsan" stu.Age = 100 // 插入(创建)数据 fmt.Println(GlobalConn.Create(&stu).Error) }
使用注意事项：
-
插入数据时，使用的 create() 函数，传参时，必须传入 &对象。如果遗漏 “&” 会报错
-
要保证 ，在插入数据库时，GlobalConn.SingularTable(true) 生效。代表不使用 复数表名。
查询:
简单查询方法：
First(&user): 获取 user 表中的第一条数据
func SearchData() { var stu Student GlobalConn.First(&stu) fmt.Println(stu) }
相当于SQL：SELECT * FROM student ORDER BY id LIMIT 1;
只查询 name、age 不查询其他值：
GlobalConn.Select("name, age").First(&stu)
Last(&user): 获取 user 表中的最后一条数据
相当于SQL：SELECT * FROM users ORDER BY id DESC LIMIT 1
Find(&user): 获取 user 表中的所有数据。
var stu []Student // 改为切片 GlobalConn.Select("name, age").Find(&stu) // Find() 查询多条
相当于SQL：select name, age from student;
条件查询:
select name, age from student where name = 'lisi'; GlobalConn.Select("name, age").Where("name = ?", "lisi").Find(&stu) select name, age from student where name = 'lisi' and age = 22; //方法1： GlobalConn.Select("name, age").Where("name = ?", "lisi"). Where("age = ?", 22).Find(&stu) //方法2： GlobalConn.Select("name, age").Where("name = ? and age = ?", "lisi", 22).Find(&stu)
有时候 数据查询不到的情况err也是非nil,这个时候可以进行判断
if gorm.IsRecordNotFoundError(err) { // 记录不存在 ... }
更新:
Save(): 根据主键更新。如果数据没有指定主键，不更新，变为 “插入”操作。
func UpdateData() { var stu Student stu.Name = "wangwu" stu.Age = 99 // 没有指定 id -- 没有主键! --- 插入 fmt.Println(GlobalConn.Save(&stu).Error) }
更新一个:
func UpdateData() { var stu Student stu.Name = "wangwu" stu.Age = 77 stu.Id = 4 //指定 id -- 更新操作! fmt.Println(GlobalConn.Save(&stu).Error) }
Update(): 更新一个字段。
fmt.Println(GlobalConn.Model(new(Student)).Where("name = ?", "zhaoliu"). Update("name", "lisi").Error) // Model(new(Student): 指定更新 “student” 表
Updates(): 更新多个字段。
fmt.Println(GlobalConn.Model(new(Student)).Where("name = ?", "lisi"). Updates(map[string]interface{}{"name":"liuqi", "age":24}).Error)
grom 删除数据
删除：物理删除。真正的执行 Delete。
软删除：逻辑删除。不真正删。不执行Delete。
创建表时，在表中添加一个 “删除字段” 。当需要删除时，更新 “删除字段”， 更新为true
查询时，不查询 “删除字段” 为 null 的值。
创建表：
// 创建全局结构体 type Student struct { gorm.Model // go语言中, 匿名成员 --- 继承! Student 继承 Model Name string Age int } // 在“Model”上，Ctrl-B 跳转至 Model 类定义。 type Model struct { ID uint `gorm:"primary_key"` CreatedAt time.Time UpdatedAt time.Time DeletedAt *time.Time `sql:"index"` } // Model 表由 mysql自动维护，不需要我们手动维护。
执行软删除：
// 使用 Delete() 参数，指定要删除的数据所在表的表名。
fmt.Println(GlobalConn.Where("name = ?", "lisi").Delete(new(Student)).Error)
db.Delete(Email{}, "email LIKE ?", "%jinzhu%")
验证：select * from student； 依然能看到 “lisi” 相关数据。但是 。delete_at 字段。被填入数据。
db.Debug().Delete(u) debug模式, 打印执行的SQL语句
在 gorm 框架中，执行 查询语句：
func SearchData() { var stu []Student GlobalConn.Find(&stu) fmt.Println(stu) }
--- 查询结果为：[ ] ---- "软删除" 成功！
想查询“软删除”的数据：
GlobalConn.Unscoped().Find(&stu)
想 实现 “物理删除”
--- 借助 Unscoped() 执行删除。
GlobalConn.Unscoped().Where("name = ?", "lisi").Delete(new(Student))
gorm 设置表属性
修改表字段大小
// 创建全局结构体 type Student struct { Id int // string -- varchar。 默认大小255. 可以在创建表时，指定大小。 Name string `gorm:"size:100;default:'xiaoming'"` Age int Class int `gorm:"not null"` }
结论：修改表属性，只能在第一次建表的时候，有效！或者给表增加新字段的时候，有效！其他场景，修改表属性 ，在 gorm 操作中，无效！
设置时间
默认MySQL数据库 有 3 种时间：
-
date： -
datetime： -
timeStamp：时间戳。——gorm中，只有timeStamp
如果必须使用 MySQL 数据库特有的 “数据类型”， 使用 “type” 关键字来设置。
// 创建全局结构体 type Student struct { Id int Name string `gorm:"size:100;default:'xiaoming'"` Age int Class int `gorm:"not null"` Join time.Time `gorm:"type:timestamp"`// 创建 Student 表指定 timestamp类型。 }
预加载: https://gorm.io/zh_CN/docs/preload.html
[Preload]
type User struct { gorm.Model Username string Orders []Order } type Order struct { gorm.Model UserID uint Price float64 } // 查找 user 时预加载相关 Order db.Preload("Orders").Find(&users) // SELECT * FROM users; // SELECT * FROM orders WHERE user_id IN (1,2,3,4); db.Preload("Orders").Preload("Profile").Preload("Role").Find(&users) // SELECT * FROM users; // SELECT * FROM orders WHERE user_id IN (1,2,3,4); // has many // SELECT * FROM profiles WHERE user_id IN (1,2,3,4); // has one // SELECT * FROM roles WHERE id IN (4,5,6); // belongs to
[Joins]
db.Joins("Company").Joins("Manager").Joins("Account").First(&user, 1) db.Joins("Company").Joins("Manager").Joins("Account").First(&user, "users.name = ?", "jinzhu") db.Joins("Company").Joins("Manager").Joins("Account").Find(&users, "users.id IN ?", []int{1,2,3,4,5})
带条件:
db.Joins("Company", DB.Where(&Company{Alive: true})).Find(&users) // SELECT `users`.`id`,`users`.`name`,`users`.`age`,`Company`.`id` AS `Company__id`,`Company`.`name` AS `Company__name` FROM `users` LEFT JOIN `companies` AS `Company` ON `users`.`company_id` = `Company`.`id` AND `Company`.`alive` = true;
示例:
CREATE TABLE `user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `name` varchar(64) NOT NULL DEFAULT '', `c_sn` int(11) NOT NULL DEFAULT '0', `created_at` datetime(3) DEFAULT NULL, `updated_at` datetime(3) DEFAULT NULL, `deleted_at` datetime(3) DEFAULT NULL, PRIMARY KEY (`id`) USING BTREE, KEY `index_casusers_on_cas_uid` (`cas_uid`) USING BTREE, ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE `company` ( `id` int(11) NOT NULL AUTO_INCREMENT, `name` varchar(64) NOT NULL DEFAULT '', `c_sn` int(11) NOT NULL DEFAULT '0', PRIMARY KEY (`id`) USING BTREE, KEY `index_c_sn` (`c_sn`) USING BTREE, ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
belongs to 会与另一个模型建立了一对一的连接。 这种模型的每一个实例都 “属于” 另一个模型的一个实例。
例如，您的应用包含 user 和 company，并且每个 user 都可以分配给一个 company
主表与其它表建立关连(关链关系字段存到主表)
// `User` 属于 `Company`， `CompanyID` 是外键 type User struct { gorm.Model Name string CompanyID int Company Company } type Company struct { ID int Name string }
重写外键: foreignKey:company_sn (指定user表里的company_sn)
User表外键默认关联Company的主键id ,可以重写成其它外键,如Company里的c_sn字段
重写引用: references:c_sn (指定company_表里的c_sn)
指定user表里的company_sn字段关联company_表里的c_sn
-
写法一:和mysql里的字段字写成一样的
gorm:"foreignKey:company_sn;references:c_sn" -
写法一:和结构体里key名写成一样的
gorm:"foreignKey:CompanySn;references:CSn"
// `User` 属于 `Company`，`CompanyID` 是外键 type User struct { gorm.Model Name string `json:"name"` CompanySn string `json:"company_sn"` //关连接company表 Company Company `json:"casusers" gorm:"foreignKey:company_sn;references:c_sn"` } type Company struct { ID int `json:"ID"` Name string `json:"name"` CSn string `json:"cSn"` } // 查找 user 时预加载相关 Company db.Joins("Company").First(&user, 1) // 查找 user 时预加载相关 Company db.Preload("Company").Find(&users)
更多参考: https://www.cnblogs.com/haima/p/14879268.html
[分页处理]
// Paginate 分页封装
func Paginate(current int,pageSize int) func(db *gorm.DB) *gorm.DB {
return func (db *gorm.DB) *gorm.DB {
if current == 0 {
current = 1
}
switch {
case pageSize > 100:
pageSize = 100
case pageSize <= 0:
pageSize = 10
}
offset := (current - 1) * pageSize
return db.Offset(offset).Limit(pageSize)
}
}
// 参数中定义
type Pagination struct {
Current int `json:"current" form:"page"` // 页码
PageSize int `json:"pageSize" form:"pageSize"` // 每页大小
}
使用:
func GetRoleList(query *request.Pagination) (err error, total int64, list []model.Role) {
db := global.GvaDb.Model(&model.Role{})
err = db.Where("deleted_at is null").Count(&total).Error
if err != nil {
return err, 0, nil
}
err = db.Scopes(utils.Paginate(query.Current, query.PageSize)).Order("created_at desc").Find(&list).Error
return err, total, list
}
注意点:
1.数据插入的时候, 如果存在created_at,则gorm会自动写入该值,使用当前时间, 如果不想这样的话, 在插入的时候, 使用Omit("UpdatedAt") 方法进行忽略
2.定义的model模型中,默认指定的字段是下划线,解析为蛇形字段, 否则的话需要再tag中执行gorm:"column:真实字段名称" 即可
更多使用参考: