gorm是什么？
ORM-Object-Relationl Mapping，即对象关系映射，这里的Relationl指的是关系型数据库
它的作用是在关系型数据库和对象之间作一个映射，这样，我们在具体的操作数据库的时候，就不需要再去和复杂的SQL语句打交道，只要像平时操作对象一样操作它就可以了
GORM就是go语言实现的一个ORM库
特点：
- 全特性 ORM (几乎包含所有特性)
- 模型关联 (一对一， 一对多，一对多（反向）， 多对多， 多态关联)
- 钩子 (Before/After Create/Save/Update/Delete/Find)
- 预加载
- 事务
- 复合主键
- SQL 构造器
- 自动迁移
- 日志
- 基于GORM回调编写可扩展插件
- 全特性测试覆盖
- 开发者友好
GORM之简单CRUD
增加(Create)
user := User{Name: "Jinzhu", Age: 18, Birthday: time.Now()}
db.NewRecord(user) // => 返回 `true` ，因为主键为空
db.Create(&user)
db.NewRecord(user) // => 在 `user` 之后创建返回 `false`
检索(Retrieve)
// 获取第一条记录，按主键排序
db.First(&user)
SELECT * FROM users ORDER BY id LIMIT 1;
// 获取一条记录，不指定排序
db.Take(&user)
SELECT * FROM users LIMIT 1;
// 获取最后一条记录，按主键排序
db.Last(&user)
SELECT * FROM users ORDER BY id DESC LIMIT 1;
// 获取所有的记录
db.Find(&users)
SELECT * FROM users;
// 通过主键进行查询 (仅适用于主键是数字类型)
db.First(&user, 10)
SELECT * FROM users WHERE id = 10;
更新(Update)
db.First(&user)
user.Name = "jinzhu 2"
user.Age = 100
db.Save(&user)
// 如果单个属性被更改了，更新它
db.Model(&user).Update("name", "hello")
UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111;
// 使用组合条件更新单个属性
db.Model(&user).Where("active = ?", true).Update("name", "hello")
UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111 AND active=true;
删除(Delete)
// 删除一条存在的记录
db.Delete(&email)
DELETE from emails where id=10;
// 为删除 SQL 语句添加额外选项
db.Set("gorm:delete_option", "OPTION (OPTIMIZE FOR UNKNOWN)").Delete(&email)
DELETE from emails where id=10 OPTION (OPTIMIZE FOR UNKNOWN);
如果模型中有 DeletedAt 字段，它将自动拥有软删除的能力！当执行删除操作时，数据并不会永久的从数据库中删除，而是将 DeletedAt 的值更新为当前时间。
具体的使用可查看gorm 官方文档
项目中声明全局GVA_DB
在项目中我们定义一个全局的GVA_DB，方便使用时调用
// global.go
var (
GVA_DB *gorm.DB
)
后续我们在需要查询数据库时便可直接通过global.GVA_DB使用
比如创建商品信息：
我们先通过查询分类是否存在，然后再创建商品
func (m *ManageGoodsInfoService) CreateMallGoodsInfo(req manageReq.GoodsInfoAddParam) (err error) {
var goodsCategory manage.MallGoodsCategory
err = global.GVA_DB.Where("category_id=? AND is_deleted=0", req.GoodsCategoryId).First(&goodsCategory).Error
if goodsCategory.CategoryLevel != enum.LevelThree.Code() {
return errors.New("分类数据异常")
}
if !errors.Is(global.GVA_DB.Where("goods_name=? AND goods_category_id=?", req.GoodsName, req.GoodsCategoryId).First(&manage.MallGoodsInfo{}).Error, gorm.ErrRecordNotFound) {
return errors.New("已存在相同的商品信息")
}
......
err = global.GVA_DB.Create(&goodsInfo).Error
return err
}
通过gorm的链式操作可以很方便的进行crud操作
分页查询
分页查询是项目中经常使用到的功能，当指定条件查询的数据量过大时，如果我们将数据一次性返回，会对数据库造成较大的负荷，同时降低接口的性能，通常我们会使用分页查询的方式让数据进行分段展示，从而保障接口的性能。在gorm中我们实用Offset，和Count来实现分页
Offset 指定在开始返回记录之前要跳过的记录数。
db.Offset(3).Find(&users) SELECT * FROM users OFFSET 3; // 用 -1 取消 OFFSET 限制条件 db.Offset(10).Find(&users1).Offset(-1).Find(&users2) SELECT * FROM users OFFSET 10; (users1) SELECT * FROM users; (users2)Count 获取模型记录数。注意： 在查询链中使用 Count 时，必须放在最后一个位置，因为它会覆盖 SELECT 查询条件。
db.Where("name = ?", "jinzhu").Or("name = ?", "jinzhu >2").Find(&users).Count(&count) SELECT * from USERS WHERE name = 'jinzhu' OR name = >'jinzhu 2'; (users) SELECT count(*) FROM users WHERE name = 'jinzhu' OR >name = 'jinzhu 2';
我们通过前端的传递过来的分页数据进行查询
func (m *ManageGoodsInfoService) GetMallGoodsInfoInfoList(info manageReq.MallGoodsInfoSearch, goodsName string, goodsSellStatus string) (err error, list interface{}, total int64) {
limit := info.PageSize
offset := info.PageSize * (info.PageNumber - 1)
// 创建db
db := global.GVA_DB.Model(&manage.MallGoodsInfo{})
var mallGoodsInfos []manage.MallGoodsInfo
// 如果有条件搜索 下方会自动创建搜索语句
err = db.Count(&total).Error
if err != nil {
return
}
if goodsName != "" {
db.Where("goods_name =?", goodsName)
}
if goodsSellStatus != "" {
db.Where("goods_sell_status =?", goodsSellStatus)
}
err = db.Limit(limit).Offset(offset).Order("goods_id desc").Find(&mallGoodsInfos).Error
return err, mallGoodsInfos, total
}
总结
该商城作为gin的学习项目，没有很复杂的逻辑，所有业务逻辑均通过Mysql实现。包括后面将要介绍的登录态，也是如此。
所有代码已上传github，有兴趣的可以访问https://github.com/newbee-ltd/newbee-mall-api-go/，如果有更好的建议也欢迎提交issure，pr
