这是我参与「第三届青训营 -后端场」笔记创作活动的第4篇笔记
gorm官方文档:GORM 指南 | GORM - The fantastic ORM library for Golang, aims to be developer friendly.
安装:
- go get gorm.io/gorm
- go get gorm.io/driver/mysql
一、gorm简介
- 全功能 ORM
- 关联 (拥有一个,拥有多个,属于,多对多,多态,单表继承)
- Create,Save,Update,Delete,Find 中钩子方法
- 支持 Preload、Joins 的预加载
- 事务,嵌套事务,Save Point,Rollback To to Saved Point
- Context、预编译模式、DryRun 模式
- 批量插入,FindInBatches,Find/Create with Map,使用 SQL 表达式、Context Valuer 进行 CRUD
- SQL 构建器,Upsert,锁,Optimizer/Index/Comment Hint,命名参数,子查询
- 复合主键,索引,约束
- 自动迁移
- 自定义 Logger
- 灵活的可扩展插件 API:Database Resolver(多数据库,读写分离)、Prometheus…
- 每个特性都经过了测试的重重考验
- 开发者友好
二、基础用法
1.连接
type User struct {
gorm.Model
Name string
}
var dsn=""
func main(){
db,err:=gorm.open(mysql.open(dsn),&gorm.config{})
if err != nil {
panic("failed to connect database")
}
db.AutoMigrate(&Product{})//没有这张表会自动创建
}
需要自己定义数据库的dsn
2.创建
u:=user{Name:"a"}
res:=db.create(&u)//同时支持批量创建
u.Name//用户姓名
res.RowsAffected//返回影响的行数
3.查询
u:=User{}
res:=db.where("id = ?",id).find(u)
res.RowsAffected//返回查询的的行数
//占位符有效的避免了SQL注入
4.更新
db.Model(&User).where("Id=?",id).Updates(Product{Id: 200}) // 仅更新非零值字段
db.Model(&User).where("Id=?",id).Updates(map[string]interface{}{"Id": 200})
db.Model(&User).where("Id=?",id).Updates("Id",gorm.Expr("Id+?", 1))
5.删除
db.Delete(&user{id:1})
6. 模型定义
- 表名为struct name的snake_ cases 复数格式
- 字段名为field name的snake_ case 单数格式
- ID/ ld字段为主键,如果为数字,则为自增主键
- CreatedAt字段,创建时,保存当前时间
- UpdatedAt字段,创建、更新时,保存当前时间
- gorm.DeletedAt字段,默认开启soft delete模式 gorm.io/docs/conven…