GORM-V1-CRUD

[TOC]

说明

请先阅读官方文档,由于官方文档对每个例子和概念解释比较简单,官方文档中个人认为比较难理解的概念在正文章节进行解释

本文须与官方文档伴食,否则将不知所云。

可对应 学习项目 实践验证。

参考

  • V1官方文档
  • ORM模型理念理解

正文

查询

gorm.DB的方法定义采用了构造模式(所以才能连调多个方法),一个把较多方法用上的查询语句如下:

//伪代码,仅作方法简单罗列参考,且其中某些函数没有场景可以同时使用,顺序也没有严格思考。
db.Table(xxx).Select(xxx).Where(xxx).Or(xxx)Order(xxx).Limit(xxx).Offset(xxx).Attrs(xxx).FirstOrInit(&user).Count(xxx)

查询一条或多条

以下方法根据方法名语义查询(PS:个人称其为语义查询),涉及排序都是以主键排序

First/Take/Last/Find/

条件查询where

  1. 调用Where方法进行条件查询

    • 带占位符的SQL语句+与占位符对应个数的参数;

    • 用Struct或Map携带条件(条件关系为And)或用切片携带主键(多个主键关系为Or)

  2. 调用语义查询方法

结构体查询注意零值问题

条件查询Not

与Where类似,语义相反,条件格式也类似Where

条件查询Or

  1. 调用Where条件方法
  2. 调用Or条件方法,且条件字段与Where相同
  3. 调用语义查询方法

个人认为完全可以使用Where的In条件代替,如下:

// IN
db.Where("name IN (?)", []string{"jinzhu", "jinzhu 2"}).Find(&users)
//// SELECT * FROM users WHERE name in ('jinzhu','jinzhu 2');

Inline Condition 内联条件

实际就是在语义查询方法内直接放查询条件(省略Where语句),条件格式包括:

  • 带占位符SQL及其条件值
  • Struct
  • Map

Extra Querying option 其它查询选项

通过gorm:query_option Tag格式指定查询行为

FirstOrInit与FirstOrCreate + 辅助方法Attrs与Assign

逻辑稍微复杂的语义查询方法,可选择性配合(可以不用)Attrs或Assign辅助方法。

  1. 调用Where条件方法
  2. 选择性配合Attrs或Assign方法
    • Attrs
      • 数据库有符合Where指定条件记录则不起作用
      • 反之则使用其指定的字段值构造结果
    • Assign(数据库有无符合Where指定条件记录都用其指定字段值做替换)
  3. 调用FirstOrInit或FirstOrCreate
    • FirstOrInit(数据库有无符合Where条件的记录都只根据步骤2规则构造结果)
    • FirstOrCreate(数据库有无符合Where条件的记录都根据步骤2规则构造结果并insert或update改变到数据库)

Advanced Query 高级查询

虽然叫高级查询,也确实逻辑较复杂,但是部分方法完全属于高级DML的方法式使用。与前文的简单DML方法式使用涉及较多参数格式和gorm抽象出来的易用方法不同,只要理解对用的高级DML就能理解这些方法的使用。所以对这部分方法不做过多解释。

  • 子查询
  • 选择字段:Select(xxx),不用的时候默认Select(*)
  • Order(xxx)
  • Limit(xxx)
  • Offset(int)
  • Count(xxx)
  • Group & Having
  • Joins(xxx)
Model
// Model specify the model you would like to run db operations
//    // update all users's name to `hello`
//    db.Model(&User{}).Update("name", "hello")
//    // if user's primary key is non-blank, will use it as condition, then will only update the user's name to `hello`
//    db.Model(&user).Update("name", "hello")
func (s *DB) Model(value interface{}) *DB {
    c := s.clone()
    c.Value = value
    return c
}

个人理解:作用与db.Table(xxx)相同,Table是通过数据库表名来指定要查询的表,Model是通过要查询的Struct的变量指针来指定要查询的表。

Pluck

对查询结果某字段取切片,相当于更简洁2、更省内存的 Select(一个字段);因为Select方式结果是对应的自定义Type切片,而Pluck方式结果是对应字段的Buildin Type切片,但二者有效内容一样。

Scan

对应面向对象思想,Find系列方法相当于直接查出PO,Scan相当于查出另外定义的VO;Scan查询的是PO的部分字段。

更新

gorm.DB的方法定义采用了构造模式(所以才能连调多个方法),一个把较多方法用上的更新语句如下:

db.Save(&user)
db.Model(&user).[Select(xxx)|Omit(xxx)].Where(xxx).Updates(xxx)
  • Save(&user) 更新id为&user.ID的记录的所有字段。
  • Update(xxx) 配合Model或Table更新指定表的指定字段,xxx可以是键值对/Map/Struct变量
    • Select(xxx) 配合此方法可以只更新指定字段
    • Omit(xxx) 配合此字段可以排除指定字段更新
  • 无Hooks更新(不会自动调用Model的Hooks方法,如:BeforeUpdate、AfterUpdate等)
    • UpdateColumn(xxx)
    • 批量更新
  • gorm.Expr(xxx) 在此方法中指定表达式
  • Set(xxx) 通过此方法指定gorm选项

删除

  • 主键删除—— db.Delete(&email),如果没指定主键删除该Model所有记录
  • 批量删除——配合Where或直接在Delete内指定筛选条件
  • 软删除—— model 有 DeletedAt 字段
  • 物理删除——配合Unscoped()方法

你可能感兴趣的:(GORM-V1-CRUD)