SDK数据库 Command·聚合操作符·条件操作符

AggregateCommand.cond(value: any): Object

支持端：小程序 2.7.4, 云函数 0.8.1, Web

聚合操作符。计算布尔表达式，返回指定的两个值其中之一。

参数

value: any

返回值

Object

API 说明

cond 的使用形式如下：

cond({ if: <布尔表达式>, then: <真值>, else: <假值>  })

或者：

cond([ <布尔表达式>, <真值>, <假值> ])

两种形式中，三个参数（if、then、else）都是必须的。

如果布尔表达式为真，那么 $cond 将会返回 <真值>，否则会返回 <假值>

示例代码

假设集合 items 的记录如下：

{ "_id": "0", "name": "item-a", "amount": 100 }
{ "_id": "1", "name": "item-b", "amount": 200 }
{ "_id": "2", "name": "item-c", "amount": 300 }

我们可以使用 cond，根据 amount 字段，来生成新的字段 discount：

const $ = db.command.aggregate
db.collection('items').aggregate()
  .project({
    name: 1,
    discount: $.cond({
        if: $.gte(['$amount', 200]),
        then: 0.7,
        else: 0.9
    })
  })
  .end()

输出如下：

{ "_id": "0", "name": "item-a", "discount": 0.9 }
{ "_id": "1", "name": "item-b", "discount": 0.7 }
{ "_id": "2", "name": "item-c", "discount": 0.7 }

AggregateCommand.ifNull(value: Expression[]): Object

支持端：小程序 2.7.4, 云函数 0.8.1, Web

聚合操作符。计算给定的表达式，如果表达式结果为 null、undefined 或者不存在，那么返回一个替代值；否则返回原值。

参数

value: Expression[]

[ <表达式>, <替代值> ]

返回值

Object

API 说明

ifNull 的使用形式如下：

ifNull([ <表达式>, <替代值> ])

示例代码

假设集合 items 的记录如下：

{ "_id": "0", "name": "A", "description": "这是商品A" }
{ "_id": "1", "name": "B", "description": null }
{ "_id": "2", "name": "C" }

我们可以使用 ifNull，对不存在 desc 字段的文档，或者 desc 字段为 null 的文档，补充一个替代值。

const $ = db.command.aggregate
db.collection('items').aggregate()
  .project({
    _id: 0,
    name: 1,
    description: $.ifNull(['$description', '商品描述空缺'])
  })
  .end()

输出如下：

{ "name": "A", "description": "这是商品A" }
{ "name": "B", "description": "商品描述空缺" }
{ "name": "C", "description": "商品描述空缺" }

AggregateCommand.switch(value: any): Object

支持端：小程序 2.7.4, 云函数 0.8.1, Web

聚合操作符。根据给定的 switch-case-default 计算返回值、

参数

value: any

返回值

Object

API 说明

switch 的使用形式如下：

switch({
    branches: [
        case: <表达式>, then: <表达式>,
        case: <表达式>, then: <表达式>,
        ...
    ],
    default: <表达式>
})

示例代码

假设集合 items 的记录如下：

{ "_id": "0", "name": "item-a", "amount": 100 }
{ "_id": "1", "name": "item-b", "amount": 200 }
{ "_id": "2", "name": "item-c", "amount": 300 }

我们可以使用 switch，根据 amount 字段，来生成新的字段 discount：

const $ = db.command.aggregate
db.collection('items').aggregate()
  .project({
    name: 1,
    discount: $.switch({
        branches: [
            { case: $.gt(['$amount', 250]), then: 0.8 },
            { case: $.gt(['$amount', 150]), then: 0.9 }
        ],
        default: 1
    })
  })
  .end()

输出如下：

{ "_id": "0", "name": "item-a", "discount": 1 }
{ "_id": "1", "name": "item-b", "discount": 0.9 }
{ "_id": "2", "name": "item-c", "discount": 0.8 }