为安全性保证、防止误操作,UpdateDelete方法必须带有Where条件才能提交执行,否则将会错误返回,错误信息如:there should be WHERE condition statement for XXX operationgoframe是一款用于企业生产级别的框架,各个模块设计严谨,工程实践的细节处理得比较好。

Update更新方法

Update用于数据的更新,往往需要结合DataWhere方法共同使用。Data方法用于指定需要更新的数据,Where方法用于指定更新的条件范围。同时,Update方法也支持直接给定数据和条件参数。

使用示例:

  1. // UPDATE `user` SET `name`='john guo' WHERE name='john'
  2. g.Model("user").Data(g.Map{"name" : "john guo"}).Where("name", "john").Update()
  3. g.Model("user").Data("name='john guo'").Where("name", "john").Update()
  4. // UPDATE `user` SET `status`=1 WHERE `status`=0 ORDER BY `login_time` asc LIMIT 10
  5. g.Model("user").Data("status", 1).Order("login_time asc").Where("status", 0).Limit(10).Update()
  6. // UPDATE `user` SET `status`=1 WHERE 1
  7. g.Model("user").Data("status=1").Where(1).Update()
  8. g.Model("user").Data("status", 1).Where(1).Update()
  9. g.Model("user").Data(g.Map{"status" : 1}).Where(1).Update()

也可以直接给Update方法传递datawhere参数:

  1. // UPDATE `user` SET `name`='john guo' WHERE name='john'
  2. g.Model("user").Update(g.Map{"name" : "john guo"}, "name", "john")
  3. g.Model("user").Update("name='john guo'", "name", "john")
  4. // UPDATE `user` SET `status`=1 WHERE 1
  5. g.Model("user").Update("status=1", 1)
  6. g.Model("user").Update(g.Map{"status" : 1}, 1)

Counter更新特性

可以使用Counter类型参数对特定的字段进行数值操作,例如:增加、减少操作。

Counter数据结构定义:

  1. // Counter is the type for update count.
  2. type Counter struct {
  3. Field string
  4. Value float64
  5. }

Counter使用示例,字段自增:

  1. updateData := g.Map{
  2. "views": &gdb.Counter{
  3. Field: "views",
  4. Value: 1,
  5. },
  6. }
  7. // UPDATE `article` SET `views`=`views`+1 WHERE `id`=1
  8. result, err := db.Update("article", updateData, "id", 1)

Counter也可以实现非自身字段的自增,例如:

  1. updateData := g.Map{
  2. "views": &gdb.Counter{
  3. Field: "clicks",
  4. Value: 1,
  5. },
  6. }
  7. // UPDATE `article` SET `views`=`clicks`+1 WHERE `id`=1
  8. result, err := db.Update("article", updateData, "id", 1)

Increment/Decrement自增/减

我们可以通过IncrementDecrement方法实现对指定字段的自增/自减常用操作。两个方法的定义如下:

  1. // Increment increments a column's value by a given amount.
  2. func (m *Model) Increment(column string, amount float64) (sql.Result, error)
  3. // Decrement decrements a column's value by a given amount.
  4. func (m *Model) Decrement(column string, amount float64) (sql.Result, error)

使用示例:

  1. // UPDATE `article` SET `views`=`views`+10000 WHERE `id`=1
  2. g.Model("article").Where("id", 1).Increment("views", 10000)
  3. // UPDATE `article` SET `views`=`views`-10000 WHERE `id`=1
  4. g.Model("article").Where("id", 1).Decrement("views", 10000)

RawSQL语句嵌入

gdb.Raw是字符串类型,该类型的参数将会直接作为SQL片段嵌入到提交到底层的SQL语句中,不会被自动转换为字符串参数类型、也不会被当做预处理参数。更详细的介绍请参考章节:ORM高级特性-RawSQL。例如:

  1. // UPDATE `user` SET login_count='login_count+1',update_time='now()' WHERE id=1
  2. g.Model("user").Data(g.Map{
  3. "login_count": "login_count+1",
  4. "update_time": "now()",
  5. }).Where("id", 1).Update()
  6. // 执行报错:Error Code: 1136. Column count doesn't match value count at row 1

使用gdb.Raw改造后:

  1. // UPDATE `user` SET login_count=login_count+1,update_time=now() WHERE id=1
  2. g.Model("user").Data(g.Map{
  3. "login_count": gdb.Raw("login_count+1"),
  4. "update_time": gdb.Raw("now()"),
  5. }).Where("id", 1).Update()

Delete删除方法

Delete方法用于数据的删除。

使用示例:

  1. // DELETE FROM `user` WHERE uid=10
  2. g.Model("user").Where("uid", 10).Delete()
  3. // DELETE FROM `user` ORDER BY `login_time` asc LIMIT 10
  4. g.Model("user").Order("login_time asc").Limit(10).Delete()

也可以直接给Delete方法传递where参数:

  1. // DELETE FROM `user` WHERE `uid`=10
  2. g.Model("user").Delete("uid", 10)
  3. // DELETE FROM `user` WHERE `score`<60
  4. g.Model("user").Delete("score < ", 60)

软删除特性

软删除特性请查看章节:ORM链式操作-时间维护