这5个方法是数据查询比较常用的方法,方法列表:
All/One/Array/Value/Count
这五个方法是数据查询比较常用的方法,方法列表:
Code Block | ||
---|---|---|
| ||
func (m *Model) All(where ...interface{} (Result, error)
func (m *Model) One(where ...interface{}) (Record, error)
func (m *Model) Array(fieldsAndWhere ...interface{}) ([]Value, error)
func (m *Model) Value(fieldsAndWhere ...interface{}) (Value, error)
func (m *Model) Count(where ...interface{}) (int, error)
func (m *Model) CountColumn(column string) (int, error) |
简要说明:
All
用于查询并返回多条记录的列表/数组。One
用于查询并返回单条记录。Array
用于查询指定字段列的数据,返回数组。Value
用于查询并返回一个字段值,往往需要结合Fields
方法使用。Count
用于查询并返回记录数。
此外,也可以看得到这四个方法定义中也支持条件参数的直接输入,参数类型与Where
方法一致。但需要注意,其中Array
和Value
方法的参数中至少应该输入字段参数。
使用示例:
Code Block | ||
---|---|---|
| ||
// SELECT * FROM `user` WHERE `score`>60
Model("user").Where("score>?", 60).All()
// SELECT * FROM `user` WHERE `score`>60 LIMIT 1
Model("user").Where("score>?", 60).One()
// SELECT `name` FROM `user` WHERE `score`>60
Model("user").Fields("name").Where("score>?", 60).Array()
// SELECT `name` FROM `user` WHERE `uid`=1 LIMIT 1
Model("user").Fields("name").Where("uid", 1).Value()
// SELECT COUNT(1) FROM `user` WHERE `status` IN(1,2,3)
Model("user").Where("status", g.Slice{1,2,3}).Count |
...
AllAndCount
该方法用于同时查询数据记录列表及总数量,一般用于分页查询场景中。方法定义如下:
...
language | go |
---|
...
( |
...
) |
...
在方法内部查询总数量时,将会忽略查询中的Limit/Page
操作。
使用示例:
Code Block | ||
---|---|---|
| ||
// SELECT `uid`,`name` FROM `user` WHERE `status`='deleted' LIMIT 0,10
// SELECT COUNT(`uid`,`name`) FROM `user` WHERE `status`='deleted'
all, count, err := Model("user").Fields("uid", "name").Where("status", "deleted").Limit(0, 10).AllAndCount(true)
// SELECT `uid`,`name` FROM `user` WHERE `status`='deleted' LIMIT 0,10
// SELECT COUNT(1) FROM `user` WHERE `status`='deleted'
all, count, err := Model("user").Fields("uid", "name").Where("status", "deleted").Limit(0, 10).AllAndCount(false) |
...
title | Content Menu |
---|
...