[TOC] # QuerySeter ORM 以**QuerySeter**來組織查詢，每個返回**QuerySeter**的方法都會獲得一個新的**QuerySeter**對象。 基本使用方法: ~~~ o := orm.NewOrm() // 獲取 QuerySeter 對象，user 為表名 qs := o.QueryTable("user") // 也可以直接使用對象作為表名 user := new(User) qs = o.QueryTable(user) // 返回 QuerySeter ~~~ ## 方法 QuerySeter 是高級查詢使用的接口，我們來熟悉下他的接口方法 * type QuerySeter interface { * [Filter(string, …interface{}) QuerySeter](https://beego.me/docs/mvc/model/query.md#filter) * [Exclude(string, …interface{}) QuerySeter](https://beego.me/docs/mvc/model/query.md#exclude) * [SetCond(\*Condition) QuerySeter](https://beego.me/docs/mvc/model/query.md#setcond) * [Limit(int, …int64) QuerySeter](https://beego.me/docs/mvc/model/query.md#limit) * [Offset(int64) QuerySeter](https://beego.me/docs/mvc/model/query.md#offset) * [GroupBy(…string) QuerySeter](https://beego.me/docs/mvc/model/query.md#groupby) * [OrderBy(…string) QuerySeter](https://beego.me/docs/mvc/model/query.md#orderby) * [Distinct() QuerySeter](https://beego.me/docs/mvc/model/query.md#distinct) * [RelatedSel(…interface{}) QuerySeter](https://beego.me/docs/mvc/model/query.md#relatedsel) * [Count() (int64, error)](https://beego.me/docs/mvc/model/query.md#count) * [Exist() bool](https://beego.me/docs/mvc/model/query.md#exist) * [Update(Params) (int64, error)](https://beego.me/docs/mvc/model/query.md#update) * [Delete() (int64, error)](https://beego.me/docs/mvc/model/query.md#delete) * [PrepareInsert() (Inserter, error)](https://beego.me/docs/mvc/model/query.md#prepareinsert) * [All(interface{}, …string) (int64, error)](https://beego.me/docs/mvc/model/query.md#all) * [One(interface{}, …string) error](https://beego.me/docs/mvc/model/query.md#one) * [Values(\*\[\]Params, …string) (int64, error)](https://beego.me/docs/mvc/model/query.md#values) * [ValuesList(\*\[\]ParamsList, …string) (int64, error)](https://beego.me/docs/mvc/model/query.md#valueslist) * [ValuesFlat(\*ParamsList, string) (int64, error)](https://beego.me/docs/mvc/model/query.md#valuesflat) * } * 每個返回 QuerySeter 的 api 調用時都會新建一個 QuerySeter，不影響之前創建的。 * 高級查詢使用 Filter 和 Exclude 來做常用的條件查詢。囊括兩種清晰的過濾規則：包含， 排除 # expr QuerySeter 中用于描述字段和 sql 操作符，使用簡單的 expr 查詢方法 字段組合的前后順序依照表的關系，比如 User 表擁有 Profile 的外鍵，那么對 User 表查詢對應的 Profile.Age 為條件，則使用`Profile__Age`注意，字段的分隔符號使用雙下劃線`__`，除了描述字段， expr 的尾部可以增加操作符以執行對應的 sql 操作。比如`Profile__Age__gt`代表 Profile.Age > 18 的條件查詢。 注釋后面將描述對應的 sql 語句，僅僅是描述 expr 的類似結果，并不代表實際生成的語句。 ~~~ qs.Filter("id", 1) // WHERE id = 1 qs.Filter("profile__age", 18) // WHERE profile.age = 18 qs.Filter("Profile__Age", 18) // 使用字段名和 Field 名都是允許的 qs.Filter("profile__age", 18) // WHERE profile.age = 18 qs.Filter("profile__age__gt", 18) // WHERE profile.age > 18 qs.Filter("profile__age__gte", 18) // WHERE profile.age >= 18 qs.Filter("profile__age__in", 18, 20) // WHERE profile.age IN (18, 20) qs.Filter("profile__age__in", 18, 20).Exclude("profile__lt", 1000) // WHERE profile.age IN (18, 20) AND NOT profile_id < 1000 ~~~ ## Operators操作符 當前支持的操作符號： * exact/iexact等于 * contains/icontains包含 * gt / gte大于 / 大于等于 * lt / lte小于 / 小于等于 * startswith/istartswith以…起始 * endswith/iendswith以…結束 * in * isnull 后面以`i`開頭的表示：大小寫不敏感