这是我参与「第五届青训营 」伴学笔记创作活动的第 3 天
一、本堂课重点内容：
本堂课主要讲了GROM（ORM框架）、Hertz（WEB框架）、Kitex（RPC框架），本文主要介绍GORM框架
二、详细知识点介绍：
ORM全称为Object Relational Mapping即对象关系映射，在Golang语境下，其中的Object对象其实说的是Golang中的结构体，Realtional说的是数据库（如MySQL），Mapping意思为映射，也就是说ORM框架让Golang中的结构体和真实的数据库间产生一种映射。实际操作中，可以将数据库的数据行映射到Golang中的结构体，然后在Golang中操作结构体最终映射到数据库，从而达到操作数据库的目的。
三、实践练习例子：
安装
**
go get -u gorm.io/gorm
go get -u gorm.io/driver/sqlite
连接MYSQL
GORM 官方支持的数据库类型有：MySQL, PostgreSQL, SQlite, SQL Server,这里只讲常见的MYSQL。其他类型数据库参见官方文档。
安装mysql依赖
**
go get -u gorm.io/driver/mysql
建立连接
a. 默认连接
**
// 默认连接
func ConnectMysqlByDefault(host, port, user, pass, dbname string) (*gorm.DB, error) {
// user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local
dns := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local",
user, pass, host, port, dbname)
return gorm.Open(mysql.Open(dns), &gorm.Config{})
}
b. 自定义配置连接
**
// 自定义配置连接
func ConnectMysqlByCustom(host, port, user, pass, dbname string) (*gorm.DB, error) {
// user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local
dns := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local",
user, pass, host, port, dbname)
return gorm.Open(mysql.New(mysql.Config{
DSN: dns,
DefaultStringSize: 256, // string 类型字段的默认长度
DisableDatetimePrecision: true, //禁用 datetime 精度，MySQL 5.6 之前的数据库不支持
DontSupportRenameIndex: true, //重命名索引时采用删除并新建的方式，MySQL 5.7 之前的数据库和 MariaDB 不支持重命名索引
DontSupportRenameColumn: true, //用change重命名列，MySQL8之前的数据库和 MariaDB 不支持重命名列
SkipInitializeWithVersion: false, // 根据当前 MySQL 版本自动配置
}))
}
c. 基于database/sql连接
**
// 基于database/sql连接，进行二次封装
func ConnectMysqlByDatabaseSql(host, port, user, pass, dbname string) (*gorm.DB, error) {
dns := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local",
user, pass, host, port, dbname)
db, err := sql.Open("mysql", dns)
if err != nil {
return nil, err
}
return gorm.Open(mysql.New(mysql.Config{Conn: db}))
}
gorm.Config配置使用,参见官方文档: gorm.io/zh_CN/docs/…
参考操作
插入
**
//插入数据
func (user *User) Insert() {
//这里使用了Table()函数，如果你没有指定全局表名禁用复数，或者是表名跟结构体名不一样的时候
//你可以自己在sql中指定表名。这里是示例，本例中这个函数可以去除。
db.Table("user").Create(user)
}
更新
**
//注意，Model方法必须要和Update方法一起使用
//使用效果相当于Model中设置更新的主键key（如果没有where指定，那么默认更新的key为id），Update中设置更新的值
//如果Model中没有指定id值，且也没有指定where条件，那么将更新全表
//相当于：update user set name='xiaoming' where id=1;
user := User{Id: 1,Name:"xiaoming"}
db.Model(&user).Update(user)
//注意到上面Update中使用了一个Struct，你也可以使用map对象。
//需要注意的是：使用Struct的时候，只会更新Struct中这些非空的字段。
//对于string类型字段的""，int类型字段0，bool类型字段的false都被认为是空白值，不会去更新表
//下面这个更新操作只使用了where条件没有在Model中指定id
//update user set name='xiaohong' wehre sex=1
db.Model(&User{}).Where("sex = ?",1).Update("name","xiaohong")
如果你想手动将某个字段set为空值, 可以使用单独选定某些字段的方式来更新：
**
user := User{Id: 1}
db.Model(&user).Select("name").Update(map[string]interface{}{"name":"","age":0})
忽略掉某些字段：
当你的更新的参数为结构体，而结构体中某些字段你又不想去更新，那么可以使用Omit方法过滤掉这些不想update到库的字段：
**
user := User{Id: 1,Name:"xioaming",Age:12}
db.Model(&user).Omit("name").Update(&user)
删除
**
//delete from user where id=1;
user := User{Id: 1}
db.Delete(&user)
//delete from user where id > 11;
db.Delete(&User{},"id > ?",11)
事务
**
func CreateAnimals(db *gorm.DB) err {
tx := db.Begin()
// 注意，一旦你在一个事务中，使用tx作为数据库句柄
if err := tx.Create(&Animal{Name: "Giraffe"}).Error; err != nil {
tx.Rollback()
return err
}
if err := tx.Create(&Animal{Name: "Lion"}).Error; err != nil {
tx.Rollback()
return err
}
tx.Commit()
return nil
}
查询：
**
func (user *User) query() (u []User) {
//查询所有记录
db.Find(&u)
//Find方法可以带 where 参数
db.Find(&u,"id > ? and age > ?",2,12)
//带where 子句的查询，注意where要在find前面
db.Where("id > ?", 2).Find(&u)
// where name in ("xiaoming","xiaohong")
db.Where("name in (?)",[]string{"xiaoming","xiaohong"}).Find(&u)
//获取第一条记录，按照主键顺序排序
db.First(&u)
//First方法可以带where 条件
db.First(&u,"where sex = ?",1)
//获取最后一条记录，按照主键顺序排序
//同样 last方法也可以带where条件
db.Last(&u)
return u
}
注意：方法中带的&u表示是返回值用u这个对象来接收。
上面的查询都将返回表中所有的字段，如果你想指定查询某些字段该怎么做呢？
指定查询字段-Select
**
//指定查询字段
db.Select("name,age").Where(map[string]interface{}{"age":12,"sex":1}).Find(&u)
使用Struct和map作为查询条件
**
//使用Struct，相当于：select * from user where age =12 and sex=1
db.Where(&User{Age:12,Sex:1}).Find(&u)
//等同上一句
db.Where(map[string]interface{}{"age":12,"sex":1}).Find(&u)
not 条件的使用
**
//where name not in ("xiaoming","xiaohong")
db.Not("name","xiaoming","xiaohong").Find(&u)
//同上
db.Not("name",[]string{"xiaoming","xiaohong"}).Find(&u)
or 的使用
**
//where age > 12 or sex = 1
db.Where("age > ?",12).Or("sex = ?",1).Find(&u)
order by 的使用
**
//order by age desc
db.Where("age > ?",12).Or("sex = ?",1).Order("age desc").Find(&u)
limit 的使用
**
//limit 10
db.Not("name",[]string{"xiaoming","xiaohong"}).Limit(10).Find(&u)
offset 的使用
**
//limit 300,10
db.Not("name",[]string{"xiaoming","xiaohong"}).Limit(10).Offset(300).Find(&u)
count(*)
**
//count(*)
var count int
db.Table("user").Where("age > ?",0).Count(&count)
注意：这里你在指定表名的情况下sql为：select count(*) from user where age > 0;
如上代码如果改为：
**
var count int
var user []User
db.Where("age > ?",0).Find(&user).Count(&count)
相当于你先查出来[]User，然后统计这个list的长度。跟你预期的sql不相符。
group & having
**
rows, _ := db.Table("user").Select("count(*),sex").Group("sex").
Having("age > ?", 10).Rows()
for rows.Next() {
fmt.Print(rows.Columns())
}
join
**
db.Table("user u").Select("u.name,u.age").Joins("left join user_ext ue on u.user_id = ue.user_id").Row()
如果有多个连接，用多个Join方法即可。
原生函数
**
db.Exec("DROP TABLE user;")
db.Exec("UPDATE user SET name=? WHERE id IN (?)", "xiaoming", []int{11,22,33})
db.Exec("select * from user where id > ?",10).Scan(&user)
四、课后个人总结：
GORM框架的关键是熟悉SQL语句，框架只是一个工具，最核心的还是数据库基础。
五、引用参考：
