参考网站
https://beego.me/docs/mvc/model/query.md
ORM 以 QuerySeter 来组织查询,每个返回 QuerySeter 的方法都会获得一个新的 QuerySeter 对象。
基本使用方法
o := orm.NewOrm()
// 获取 QuerySeter 对象,user 为表名
qs := o.QueryTable("user")
// 也可以直接使用对象作为表名
user := new(User)
qs = o.QueryTable(user) // 返回 QuerySeter
示例
package main
import (
"mysite/models"
"fmt"
"github.com/astaxie/beego"
"github.com/astaxie/beego/orm"
_ "github.com/go-sql-driver/mysql"
)
func init() {
mysqlhost := beego.AppConfig.String("mysqlhost")
mysqlport := beego.AppConfig.String("mysqlport")
mysqluser := beego.AppConfig.String("mysqluser")
mysqlpass := beego.AppConfig.String("mysqlpass")
mysqldb := beego.AppConfig.String("mysqldb")
//注册mysql Driver
orm.RegisterDriver("mysql", orm.DRMySQL)
//注册数据库直接连接
// orm.RegisterDataBase("default", "mysql", "root:root@/orm_test?charset=utf8")
//用户名:密码@tcp(url地址)/数据库 ,名字对应app.conf配置数据库信息
conn := mysqluser + ":" + mysqlpass + "@tcp(" + mysqlhost + ":" + mysqlport + ")/" + mysqldb + "?charset=utf8"
//注册数据库连接
orm.RegisterDataBase("default", "mysql", conn)
fmt.Printf("数据库连接成功!%s\n", conn)
}
func main() {
orm.Debug= true
o := orm.NewOrm()
// 也可以直接使用对象作为表名
// 返回 QuerySeter
user := new(models.User)
qs := o.QueryTable(user)
na, err := qs.Filter("Id", 1).All(user)
// 或者简写
// qs, err := o.QueryTable(user).Filter("Id", 1).All(user)
fmt.Printf("%d ------ %v", na, err)
gt, err := o.QueryTable(user).Filter("Id__gt", 5).All(user)
fmt.Printf("%d ######## %v", gt, err)
// 依据当前查询条件,进行批量更新操作
// SET name = "myvic" WHERE name = "qwe"
num, err := o.QueryTable("user").Filter("name", "qwe").Update(orm.Params{
"name": "myvic",
})
fmt.Printf("Affected Num: %d, %v", num, err)
// 依据当前查询条件,进行批量删除操作
// DELETE FROM user WHERE name = "asd"
num1, err := o.QueryTable("user").Filter("name", "asd").Delete()
fmt.Printf("Affected Num: %d, %v", num1, err)
// All 返回对应的结果集对象,受到 Limit 的限制,默认最大行数为 1000
var u []*models.User
num2, err := o.QueryTable("user").Filter("Name", "myvic").All(&u)
// 可以指定返回的字段
// num2, err := o.QueryTable("user").Filter("Name", "myvic").All(&u, "Id", "Name")
fmt.Printf("Returned Rows Num: %d, %v", num2, err)
//返回结果集的 key => value 值
var maps []orm.Params
num, err = o.QueryTable("user").Values(&maps)
if err == nil {
fmt.Printf("Result Nums: %d\n", num)
for _, m := range maps {
fmt.Println(m["Id"], m["Name"])
}
}
beego.Run()
}
Operators
字段组合的前后顺序依照表的关系,比如 User 表拥有 Profile 的外键,那么对 User 表查询对应的 Profile.Age 为条件,
则使用 Profile__Age 注意,字段的分隔符号使用双下划线 __,除了描述字段, expr 的尾部可以增加操作符以执行对应的 sql 操作。
比如 Profile__Age__gt 代表 Profile.Age > 18 的条件查询。
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("name", "slene") // WHERE name = 'slene'
qs.Filter("name__exact", "slene") // WHERE name = 'slene' // 使用 = 匹配
qs.Filter("name__iexact", "slene") // WHERE name LIKE 'slene' // 大小写不敏感,匹配任意 'Slene' 'sLENE'
qs.Filter("name__contains", "slene")
// WHERE name LIKE BINARY '%slene%'
// 大小写敏感, 匹配包含 slene 的字符
qs.Filter("name__icontains", "slene")
// WHERE name LIKE '%slene%'
// 大小写不敏感, 匹配任意 'im Slene', 'im sLENE'
qs.Filter("age__in", 17, 18, 19, 20)
// WHERE age IN (17, 18, 19, 20)
qs.Filter("profile__age__gt", 17)
// WHERE profile.age > 17
qs.Filter("profile__age__gte", 18)
// WHERE profile.age >= 18
qs.Filter("profile__age__lt", 17)
// WHERE profile.age < 17
qs.Filter("profile__age__lte", 18)
// WHERE profile.age <= 18
qs.Filter("name__startswith", "slene")
// WHERE name LIKE BINARY 'slene%'
// 大小写敏感, 匹配以 'slene' 起始的字符串
qs.Filter("name__istartswith", "slene")
// WHERE name LIKE 'slene%'
// 大小写不敏感, 匹配任意以 'slene', 'Slene' 起始的字符串
qs.Filter("name__endswith", "slene")
// WHERE name LIKE BINARY '%slene'
// 大小写敏感, 匹配以 'slene' 结束的字符串
qs.Filter("name__iendswithi", "slene")
// WHERE name LIKE '%slene'
// 大小写不敏感, 匹配任意以 'slene', 'Slene' 结束的字符串
qs.Filter("profile__isnull", true)
qs.Filter("profile_id__isnull", true)
// WHERE profile_id IS NULL
qs.Filter("profile__isnull", false)
// WHERE profile_id IS NOT NULL
用来过滤查询结果,起到 包含条件 的作用
多个 Filter 之间使用 AND 连接
qs.Filter("profile__isnull", true).Filter("name", "slene")
// WHERE profile_id IS NULL AND name = 'slene'
使用 NOT 排除条件
多个 Exclude 之间使用 AND 连接
qs.Exclude("profile__isnull", true).Filter("name", "slene")
// WHERE NOT profile_id IS NULL AND name = 'slene'
// 依据当前查询条件,进行批量更新操作
// SET name = "myvic" WHERE name = "qwe"
num, err := o.QueryTable("user").Filter("name", "qwe").Update(orm.Params{
"name": "myvic",
})
fmt.Printf("Affected Num: %d, %v", num, err)
// Delete
// 依据当前查询条件,进行批量删除操作
// DELETE FROM user WHERE name = "asd"
num1, err := o.QueryTable("user").Filter("name", "asd").Delete()
fmt.Printf("Affected Num: %d, %v", num1, err)
// All 返回对应的结果集对象,受到 Limit 的限制,默认最大行数为 1000
var u []*models.User
num2, err := o.QueryTable("user").Filter("Name", "myvic").All(&u)
// 可以指定返回的字段
// num2, err := o.QueryTable("user").Filter("Name", "myvic").All(&u, "Id", "Name")
fmt.Printf("Returned Rows Num: %d, %v", num2, err)
// Values
// 返回结果集的 key => value 值
key 为Model里的Field name, value的值是interface{}类型,
例如,如果你要将value赋值给struct中的某字段,返回指定的 Field 数据
需要根据结构体对应字段类型使用断言获取真实值。举例:Name : m["Name"].(string)
var maps []orm.Params
num, err = o.QueryTable("user").Values(&maps)
if err == nil {
fmt.Printf("Result Nums: %d\n", num)
for _, m := range maps {
fmt.Println(m["Id"], m["Name"])
}
}
// 暂不支持级联查询 RelatedSel 直接返回 Values
// 但可以直接指定 expr 级联返回需要的数据
var maps []orm.Params
num, err := o.QueryTable("user").Values(&maps, "id", "name", "profile", "profile__age")
if err == nil {
fmt.Printf("Result Nums: %d\n", num)
for _, m := range maps {
fmt.Println(m["Id"], m["Name"], m["Profile"], m["Profile__Age"])
// map 中的数据都是展开的,没有复杂的嵌套
}
}
// ValuesList
// 顾名思义,返回的结果集以slice存储
// 结果的排列与 Model 中定义的 Field 顺序一致
// 返回的每个元素值以 string 保存
var lists []orm.ParamsList
num, err := o.QueryTable("user").ValuesList(&lists)
if err == nil {
fmt.Printf("Result Nums: %d\n", num)
for _, row := range lists {
fmt.Println(row)
}
}
// 当然也可以指定 expr 返回指定的 Field
var lists []orm.ParamsList
num, err := o.QueryTable("user").ValuesList(&lists, "name", "profile__age")
if err == nil {
fmt.Printf("Result Nums: %d\n", num)
for _, row := range lists {
fmt.Printf("Name: %s, Age: %s\m", row[0], row[1])
}
}
// ValuesFlat
// 只返回特定的 Field 值,将结果集展开到单个 slice 里
var list orm.ParamsList
num, err := o.QueryTable("user").ValuesFlat(&list, "name")
if err == nil {
fmt.Printf("Result Nums: %d\n", num)
fmt.Printf("All User Names: %s", strings.Join(list, ", "))
}