[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`开头的表示:大小写不敏感
- 基础
- 简介
- 主要特征
- 变量和常量
- 编码转换
- 数组
- byte与rune
- big
- sort接口
- 和mysql类型对应
- 函数
- 闭包
- 工作区
- 复合类型
- 指针
- 切片
- map
- 结构体
- sync.Map
- 随机数
- 面向对象
- 匿名组合
- 方法
- 接口
- 权限
- 类型查询
- 异常处理
- error
- panic
- recover
- 自定义错误
- 字符串处理
- 正则表达式
- json
- 文件操作
- os
- 文件读写
- 目录
- bufio
- ioutil
- gob
- 栈帧的内存布局
- shell
- 时间处理
- time详情
- time使用
- new和make的区别
- container
- list
- heap
- ring
- 测试
- 单元测试
- Mock依赖
- delve
- 命令
- TestMain
- path和filepath包
- log日志
- 反射
- 详解
- plugin包
- 信号
- goto
- 协程
- 简介
- 创建
- 协程退出
- runtime
- channel
- select
- 死锁
- 互斥锁
- 读写锁
- 条件变量
- 嵌套
- 计算单个协程占用内存
- 执行规则
- 原子操作
- WaitGroup
- 定时器
- 对象池
- sync.once
- 网络编程
- 分层模型
- socket
- tcp
- udp
- 服务端
- 客户端
- 并发服务器
- Http
- 简介
- http服务器
- http客户端
- 爬虫
- 平滑重启
- context
- httptest
- 优雅中止
- web服务平滑重启
- beego
- 安装
- 路由器
- orm
- 单表增删改查
- 多级表
- orm使用
- 高级查询
- 关系查询
- SQL查询
- 元数据二次定义
- 控制器
- 参数解析
- 过滤器
- 数据输出
- 表单数据验证
- 错误处理
- 日志
- 模块
- cache
- task
- 调试模块
- config
- 部署
- 一些包
- gjson
- goredis
- collection
- sjson
- redigo
- aliyunoss
- 密码
- 对称加密
- 非对称加密
- 单向散列函数
- 消息认证
- 数字签名
- mysql优化
- 常见错误
- go run的错误
- 新手常见错误
- 中级错误
- 高级错误
- 常用工具
- 协程-泄露
- go env
- gometalinter代码检查
- go build
- go clean
- go test
- 包管理器
- go mod
- gopm
- go fmt
- pprof
- 提高编译
- go get
- 代理
- 其他的知识
- go内存对齐
- 细节总结
- nginx路由匹配
- 一些博客
- redis为什么快
- cpu高速缓存
- 常用命令
- Go 永久阻塞的方法
- 常用技巧
- 密码加密解密
- for 循环迭代变量
- 备注
- 垃圾回收
- 协程和纤程
- tar-gz
- 红包算法
- 解决golang.org/x 下载失败
- 逃逸分析
- docker
- 镜像
- 容器
- 数据卷
- 网络管理
- 网络模式
- dockerfile
- docker-composer
- 微服务
- protoBuf
- GRPC
- tls
- consul
- micro
- crontab
- shell调用
- gorhill/cronexpr
- raft
- go操作etcd
- mongodb