• 查询条件方法

    查询条件方法

    查询和统计主要使用Get, Find, Count, Rows, Iterate这几个方法，同时大部分函数在调用Update, Delete时也是可用的。在进行查询时可以使用多个方法来形成查询条件，条件函数如下：

    • Alias(string)

    给Table设定一个别名

    1. engine.Alias("o").Where("o.name = ?", name).Get(&order)
    • And(string, …interface{})

    和Where函数中的条件基本相同，作为条件

    1. engine.Where(...).And(...).Get(&order)
    • Asc(…string)

    指定字段名正序排序，可以组合

    1. engine.Asc("id").Find(&orders)
    • Desc(…string)

    指定字段名逆序排序，可以组合

    1. engine.Asc("id").Desc("time").Find(&orders)
    • ID(interface{})

    传入一个主键字段的值，作为查询条件，如

    1. var user User
    2. engine.ID(1).Get(&user)
    3. // SELECT * FROM user Where id = 1

    如果是复合主键，则可以

    1. engine.ID(core.PK{1, "name"}).Get(&user)
    2. // SELECT * FROM user Where id =1 AND name= 'name'

    传入的两个参数按照struct中pk标记字段出现的顺序赋值。

    • Or(interface{}, …interface{})

    和Where函数中的条件基本相同，作为条件

    • OrderBy(string)

    按照指定的顺序进行排序

    • Select(string)

    指定select语句的字段部分内容，例如：

    1. engine.Select("a.*, (select name from b limit 1) as name").Find(&beans)
    3. engine.Select("a.*, (select name from b limit 1) as name").Get(&bean)
    • SQL(string, …interface{})

    执行指定的Sql语句，并把结果映射到结构体。有时，当选择内容或者条件比较复杂时，可以直接使用Sql，例如：

    1. engine.SQL("select * from table").Find(&beans)
    • Where(string, …interface{})

    和SQL中Where语句中的条件基本相同，作为条件

    1. engine.Where("a = ? AND b = ?", 1, 2).Find(&beans)
    3. engine.Where(builder.Eq{"a":1, "b": 2}).Find(&beans)
    5. engine.Where(builder.Eq{"a":1}.Or(builder.Eq{"b": 2})).Find(&beans)
    • In(string, …interface{})

    某字段在一些值中，这里需要注意必须是[]interface{}才可以展开，由于Go语言的限制，[]int64等不可以直接展开，而是通过传递一个slice。第二个参数也可以是一个*builder.Builder 指针。示例代码如下：

    1. // select from table where column in (1,2,3)
    2. engine.In("cloumn", 1, 2, 3).Find()
    4. // select from table where column in (1,2,3)
    5. engine.In("column", []int{1, 2, 3}).Find()
    7. // select from table where column in (select column from table2 where a = 1)
    8. engine.In("column", builder.Select("column").From("table2").Where(builder.Eq{"a":1})).Find()
    • Cols(…string)

    只查询或更新某些指定的字段，默认是查询所有映射的字段或者根据Update的第一个参数来判断更新的字段。例如：

    1. engine.Cols("age", "name").Get(&usr)
    2. // SELECT age, name FROM user limit 1
    3. engine.Cols("age", "name").Find(&users)
    4. // SELECT age, name FROM user
    5. engine.Cols("age", "name").Update(&user)
    6. // UPDATE user SET age=? AND name=?
    • AllCols()

    查询或更新所有字段，一般与Update配合使用，因为默认Update只更新非0，非””，非bool的字段。

    1. engine.AllCols().Id(1).Update(&user)
    2. // UPDATE user SET name = ?, age =?, gender =? WHERE id = 1
    • MustCols(…string)

    某些字段必须更新，一般与Update配合使用。

    • Omit(…string)

    和cols相反，此函数指定排除某些指定的字段。注意：此方法和Cols方法不可同时使用。

    1. // 例1：
    2. engine.Omit("age", "gender").Update(&user)
    3. // UPDATE user SET name = ? AND department = ?
    4. // 例2：
    5. engine.Omit("age, gender").Insert(&user)
    6. // INSERT INTO user (name) values (?) // 这样的话age和gender会给默认值
    7. // 例3：
    8. engine.Omit("age", "gender").Find(&users)
    9. // SELECT name FROM user //只select除age和gender字段的其它字段
    • Distinct(…string)

    按照参数中指定的字段归类结果。

    1. engine.Distinct("age", "department").Find(&users)
    2. // SELECT DISTINCT age, department FROM user

    注意：当开启了缓存时，此方法的调用将在当前查询中禁用缓存。因为缓存系统当前依赖Id，而此时无法获得Id

    • Table(nameOrStructPtr interface{})

    传入表名称或者结构体指针，如果传入的是结构体指针，则按照IMapper的规则提取出表名

    • Limit(int, …int)

    限制获取的数目，第一个参数为条数，第二个参数表示开始位置，如果不传则为0

    • Top(int)

    相当于Limit(int, 0)

    • Join(string,interface{},string)

    第一个参数为连接类型，当前支持INNER, LEFT OUTER, CROSS中的一个值，第二个参数为string类型的表名，表对应的结构体指针或者为两个值的[]string，表示表名和别名，第三个参数为连接条件

    1. 详细用法参见 [5.Join的使用](5.join.md)
    • GroupBy(string)

    Groupby的参数字符串

    • Having(string)

    Having的参数字符串