# 使用謂詞表達(dá)式進(jìn)行查詢細(xì)化

## 謂詞

在位置路徑中的任何步驟中，都可以使用謂詞過濾所選項(xiàng)目 -`[expr]` 其中 `expr` 計(jì)算結(jié)果為布爾值。選擇中的每個(gè)項(xiàng)目都根據(jù)表達(dá)式進(jìn)行測(cè)試，如果計(jì)算結(jié)果為 `true`，則保留該項(xiàng)目；如果為 `false`，則將其從選擇中刪除。表達(dá)式是相對(duì)于正在測(cè)試的當(dāng)前（上下文）項(xiàng)目進(jìn)行評(píng)估的，因此如果謂詞表達(dá)式執(zhí)行導(dǎo)航，則它相對(duì)于此上下文項(xiàng)目。

#### 例子：

* 選擇具有等于字段 `Phone` 的項(xiàng)目。`type"mobile"`

```
Phone[type='mobile']
//結(jié)果
{ "type": "mobile",  "number": "077 7700 1234" }
```

* 選擇手機(jī)號(hào)碼

```
Phone[type='mobile'].number
//結(jié)果 
"077 7700 1234"
```

* 選擇辦公室電話號(hào)碼 - 有兩個(gè)！

```
Phone[type='office'].number
//結(jié)果
[ "01962 001234",  "01962 001235" ]
```

## 單例數(shù)組和值等價(jià)

在 JSONata 表達(dá)式或子表達(dá)式中，任何值（本身不是數(shù)組）和僅包含該值的數(shù)組都被視為等價(jià)。這使得語(yǔ)言具有可組合性，以便從對(duì)象中提取單個(gè)值的位置路徑和從數(shù)組中提取多個(gè)值的位置路徑都可以用作其他表達(dá)式的輸入，而無(wú)需對(duì)這兩種形式使用不同的語(yǔ)法。

請(qǐng)考慮以下示例：

* `Address.City` 返回單一值 `"Winchester"`
* `Phone[0].number` 匹配單個(gè)值并返回該值 `"0203 544 1234"`
* `Phone[type='home'].number` 同樣匹配單個(gè)值 `"0203 544 1234"`
* `Phone[type='office'].number` 匹配兩個(gè)值，因此返回一個(gè)數(shù)組 `[ "01962 001234", "01962 001235" ]`

在處理 JSONata 表達(dá)式的返回值時(shí)，無(wú)論匹配了多少個(gè)值，結(jié)果可能都希望格式一致。在上面的前兩個(gè)表達(dá)式中，很明顯每個(gè)表達(dá)式都在處理結(jié)構(gòu)中的單個(gè)值，并且只返回該值是有意義的。然而，在最后兩個(gè)表達(dá)式中，匹配的值數(shù)量并不是很明顯，如果宿主語(yǔ)言必須根據(jù)返回的內(nèi)容以不同的方式處理結(jié)果，那就沒有用了。

如果擔(dān)心這一點(diǎn)，則可以修改表達(dá)式，使其即使只匹配一個(gè)值也返回一個(gè)數(shù)組。這可以通過 `[]` 在位置路徑中的某個(gè)步驟中添加空方括號(hào)來實(shí)現(xiàn)。上述示例可以重寫為始終返回一個(gè)數(shù)組，如下所示：

* `Address[].City` 返回 `[ "Winchester"]`
* `Phone[0][].number` 返回 `[ "0203 544 1234" ]`
* `Phone[][type='home'].number` 返回 `[ "0203 544 1234" ]`
* `Phone[type='office'].number[]` 返回 `[ "01962 001234", "01962 001235" ]`

請(qǐng)注意，`[]` 可以放置在謂詞的任一側(cè)以及路徑表達(dá)式中的任何步驟上

## 通配符

使用 `*` 而不是字段名稱來選擇對(duì)象中的所有字段

#### 示例

* 選擇所有字段的值 `Address`

```
Address.*
//結(jié)果
[ "Hursley Park", "Winchester", "SO21 2JN" ]
```

* 選擇任意 `Postcode` 子對(duì)象的值

```
*.Postcode
//結(jié)果  
"SO21 2JN"
```

## 導(dǎo)航任意深度

后代通配符 `**` 代替 `*` 將遍歷所有后代（多級(jí)通配符）。

#### 示例

* 選擇所有 `Postcode` 值，無(wú)論它們?cè)诮Y(jié)構(gòu)中的嵌套深度如何

```
**.Postcode 
//結(jié)果 
[ "SO21 2JN", "E1 6RF" ]
```

2、謂詞查詢