下面我们对其中的几个常用方法做简单介绍，其他条件查询方法用法类似。

Where/WhereOr查询条件

这两个方法用于传递查询条件参数，支持的参数为任意的string/map/slice/struct/*struct类型。

Where条件参数推荐使用字符串的参数传递方式（并使用?占位符预处理），因为map/struct类型作为查询参数无法保证顺序性，且在部分情况下（数据库有时会帮助你自动进行查询索引优化），数据库的索引和你传递的查询条件顺序有一定关系。

当使用多个Where方法连接查询条件时，多个条件之间使用And进行连接。 此外，当存在多个查询条件时，gdb会默认将多个条件分别使用()符号进行包含，这种设计可以非常友好地支持查询条件分组。

  1. // WHERE `uid`=1
  2. Where("uid=1")
  3. Where("uid", 1)
  4. Where("uid=?", 1)
  5. Where(g.Map{"uid" : 1})
  6. // WHERE `uid` <= 1000 AND `age` >= 18
  7. Where(g.Map{
  8.     "uid <=" : 1000,
  9.     "age >=" : 18,
  10. })
  12. // WHERE (`uid` <= 1000) AND (`age` >= 18)
  13. Where("uid <=?", 1000).Where("age >=?", 18)
  14. // WHERE `level`=1 OR `money`>=1000000
  17. // WHERE (`level`=1) OR (`money`>=1000000)
  18. Where("level", 1).WhereOr("money >=", 1000000)
  20. // WHERE `uid` IN(1,2,3)
  21. Where("uid IN(?)", g.Slice{1,2,3})

使用struct参数的示例，其中orm的tag用于指定struct属性与表字段的映射关系：

  1. type Condition struct{
  2.     Sex int `orm:"sex"`
  3.     Age int `orm:"age"`
  4. }
  5. Where(Condition{1, 18})
  6. // WHERE `sex`=1 AND `age`=18

使用示例

Where + string，条件参数使用字符串和预处理。

Where + slice，预处理参数可直接通过slice参数给定。

  1. // SELECT * FROM user WHERE age>18 AND name like '%john%'
  2. g.Model("user").Where("age>? AND name like ?", g.Slice{18, "%john%"}).All()
  4. g.Model("user").Where("status=?", g.Slice{1}).All()

Where + map，条件参数使用任意map类型传递。

  1. // SELECT * FROM user WHERE uid=1 AND name='john' LIMIT 1
  2. g.Model("user").Where(g.Map{"uid" : 1, "name" : "john"}).One()
  4. // SELECT * FROM user WHERE uid=1 AND age>18 LIMIT 1
  5. g.Model("user").Where(g.Map{"uid" : 1, "age>" : 18}).One()

以上的查询条件相对比较简单，我们来看一个比较复杂的查询示例。

  1. condition := g.Map{
  2.     "title like ?"         : "%九寨%",
  3.     "online"               : 1,
  4.     "hits between ? and ?" : g.Slice{1, 10},
  5.     "exp > 0"              : nil,
  6.     "category"             : g.Slice{100, 200},
  7. }
  8. // SELECT * FROM article WHERE title like '%九寨%' AND online=1 AND hits between 1 and 10 AND exp > 0 AND category IN(100,200)
  9. g.Model("article").Where(condition).All()

Wheref格式化条件字符串

在某些场景中，在输入带有字符串的条件语句时，往往需要结合fmt.Sprintf来格式化条件（当然，注意在字符串中使用占位符代替变量的输入而不是直接将变量格式化），因此我们提供了Where+fmt.Sprintf结合的便捷方法Wheref。使用示例：

  1. // WHERE score > 100 and status in('succeeded','completed')
  2. Wheref(`score > ? and status in (?)`, 100, g.Slice{"succeeded", "completed"})

WherePri支持主键的查询条件

WherePri方法的功能同Where，但提供了对表主键的智能识别，常用于根据主键的便捷数据查询。假如user表的主键为uid，我们来看一下Where与WherePri的区别：

可以看到，当使用WherePri方法且给定参数为单一的参数基本类型或者类型时，将会被识别为主键的查询条件值。