查找记录

译者：飞龙

来源：Finding items

find

查找匹配标准的记录，可以链式查询（见下文）：

  1. Person.find({status:'active'}, function(err, results) {
  2.   // ...
  3. });

你也可以限制结果的个数，这条语句限制结果为10个：

  1. Person.find({status:'active'}, 10, function(err, results) {
  2.   // ...
  3. });

Person.all是Person.find的别名。

get

通过主键来查找记录。

  1. Person.get(1, function(err, person) {
  2.   // ...
  3. });

one

只查找一个记录，和find的语法相似。

  1. Person.one({status:'active'}, function(err, person) {
  2.   // ...
  3. });

count

获取所匹配记录的数量。

  1. Person.count({status:'active'}, function(err, activePeopleCount) {
  2.   // ...
  3. });

exists

测试匹配你的条件的记录是否存在。

  1. Person.exists({id:1, status:'active'}, function(err, personIsActive) {
  2.   // ...
  3. });

过滤和排序

我们接受两个对象来执行过滤（第一个）和聚合（第二个）。聚合对象接受limit，order和groupBy。

https://github.com/dresende/node-orm2/blob/v2.1.20/lib/AggregateFunctions.js#L36

  1. Person.find({status:'active'}, {limit:10}, function(err, res) {
  3. });

find/count/one 等方法的条件查询

所有以逗号分隔的键值对在查询中都会以AND连接。你可以把逻辑运算符放在一系列条件的前面。

  1. Person.find({or:[{col1: 1}, {col2: 2}]}, function(err, res) {
  2.   // res 为 col1 == 1 或者 col2 == 2 的 Person
  3. });

使用IN来查找

sql-query（取决于SQL引擎）会自动将数组视为基于IN的查询。

https://github.com/dresende/node-sql-query/blob/v0.1.23/lib/Where.js#L172

  1. Person.find({id: [1, 2]}, function(err, persons) {
  2.   // 查找 id 是 1 或者 2 的 Person （例如 WHERE id IN (1, 2) ）
  3. });