# 簡(jiǎn)單查詢

為了支持從 JSON 結(jié)構(gòu)中提取值，定義了位置路徑語(yǔ)法。與 XPath 一樣，這將選擇文檔中與指定位置路徑匹配的所有可能值。JSON 的兩個(gè)結(jié)構(gòu)構(gòu)造是對(duì)象和數(shù)組。

## 瀏覽 JSON 對(duì)象

JSON 對(duì)象是關(guān)聯(lián)數(shù)組（又稱為映射或哈希）。用于導(dǎo)航到任意深度嵌套的 JSON 對(duì)象結(jié)構(gòu)的位置路徑語(yǔ)法包括由點(diǎn)“.”分隔符分隔的字段名稱。表達(dá)式返回導(dǎo)航到位置路徑中的最后一步后引用的 JSON 值。如果在位置路徑導(dǎo)航過(guò)程中未找到字段，則表達(dá)式不返回任何內(nèi)容（由 Javascript *undefined* 表示）。不會(huì)因輸入文檔中不存在數(shù)據(jù)而引發(fā)任何錯(cuò)誤。

除非另有說(shuō)明，本指南中的示例均使用以下示例 JSON 文檔：

```json
{
  "FirstName": "Fred",
  "Surname": "Smith",
  "Age": 28,
  "Address": {
    "Street": "Hursley Park",
    "City": "Winchester",
    "Postcode": "SO21 2JN"
  },
  "Phone": [
    {
      "type": "home",
      "number": "0203 544 1234"
    },
    {
      "type": "office",
      "number": "01962 001234"
    },
    {
      "type": "office",
      "number": "01962 001235"
    },
    {
      "type": "mobile",
      "number": "077 7700 1234"
    }
  ],
  "Email": [
    {
      "type": "work",
      "address": ["fred.smith@my-work.com", "fsmith@my-work.com"]
    },
    {
      "type": "home",
      "address": ["freddy@my-social.com", "frederic.smith@very-serious.com"]
    }
  ],
  "Other": {
    "Over 18 ?": true,
    "Misc": null,
    "Alternative.Address": {
      "Street": "Brick Lane",
      "City": "London",
      "Postcode": "E1 6RF"
    }
  }
}
```

#### 示例

以下是一些示例表達(dá)式及其應(yīng)用于上述 JSON 文檔的結(jié)果：

* 返回 JSON 字符串（“雙引號(hào)”）

```
Surname
// 結(jié)果
“smith”
```

* 返回 JSON 數(shù)字

```
Age
// 結(jié)果
  28
```

* 字段引用以“.”分隔。

```
Address.City
//結(jié)果
"Winchester"
```

* 匹配路徑并返回空值

```
Other.Misc
// 結(jié)果 
null
```

* 未找到路徑。不返回任何內(nèi)容（即 Javascript *未定義* ）
  
  ```
  Other.nothing 
  //結(jié)果
  ```
* 包含空格或保留標(biāo)記的字段引用可以用反引號(hào)括起來(lái)

```
Other.`Over 18 ?` 
// 結(jié)果
true
```

## 瀏覽 JSON 數(shù)組

當(dāng)需要有序的值集合時(shí)，將使用 JSON 數(shù)組。數(shù)組中的每個(gè)值都與一個(gè)索引（位置）而不是名稱相關(guān)聯(lián)，因此為了尋址數(shù)組中的各個(gè)值，需要額外的語(yǔ)法來(lái)指定索引。這是通過(guò)使用數(shù)組字段名稱后的方括號(hào)來(lái)完成的。如果方括號(hào)包含數(shù)字或計(jì)算結(jié)果為數(shù)字的表達(dá)式，則該數(shù)字代表要選擇的值的索引。索引是零偏移，即數(shù)組中的第一個(gè)值 `arr` 是 `arr[0]`。如果數(shù)字不是整數(shù)，則將其向下舍入*為*整數(shù)。如果方括號(hào)中的表達(dá)式是非數(shù)字的，或者是不能計(jì)算為數(shù)字的表達(dá)式，則將其視為[謂詞](http://docs.jsonata.org/predicate#predicates)。

負(fù)索引從數(shù)組末尾開(kāi)始計(jì)數(shù)，例如，`arr[-1]` 將選擇最后一個(gè)值、`arr[-2]` 倒數(shù)第二個(gè)值等等。如果指定的索引超出了數(shù)組的大小，則不會(huì)選擇任何內(nèi)容。

如果數(shù)組未指定索引（即字段引用后沒(méi)有方括號(hào)），則選擇整個(gè)數(shù)組。如果數(shù)組包含對(duì)象，并且位置路徑選擇這些對(duì)象中的字段，則將查詢數(shù)組中的每個(gè)對(duì)象以進(jìn)行選擇。

#### 示例

* 返回第一項(xiàng)（一個(gè)對(duì)象）

```
Phone[0]
// 結(jié)果
{ "type": "home", "number": "0203 544 1234" } `
```

* 返回第二項(xiàng)

```
Phone[1]
//結(jié)果
{ "type": "office", "number": "01962 001234" }
```

* 返回最后一項(xiàng)

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

* 從末尾開(kāi)始的負(fù)索引計(jì)數(shù)

```
Phone[-2]
//結(jié)果
{ "type": "office", "number": "01962 001235" }
```

* 不存在 - 不返回任何內(nèi)容

```
Phone[8]
//結(jié)果
```

* 選擇 `number` 第一項(xiàng)中的字段

```
Phone[0].number 
 //結(jié)果 
"0203 544 1234"
```

* 由于沒(méi)有給出索引，`Phone` 因此它選擇所有元素（整個(gè)數(shù)組），然后選擇 `number` 每個(gè)元素的所有字段

```
Phone.number  
//結(jié)果   
[ "0203 544 1234", "01962 001234", "01962 001235", "077 7700 1234" ]
```

* 可能期望它只返回第一個(gè)數(shù)字，但它返回所選的每個(gè)項(xiàng)目的第一個(gè)數(shù)字 `Phone`

```
Phone.number[0]
// 結(jié)果  
[ "0203 544 1234", "01962 001234", "01962 001235", "077 7700 1234" ]
```

* 將索引應(yīng)用于 返回 `Phone.number` 的數(shù)組。使用一次[括號(hào)](http://docs.jsonata.org/composition#parenthesized-expressions-and-blocks)。
  
  ```
  (Phone.number)[0]
  //結(jié)果
  "0203 544 1234"
  ```
  
  ```
  
  ```
* 通過(guò)創(chuàng)建索引數(shù)組返回一系列項(xiàng)目

```
Phone[[0..1]]|
// 結(jié)果
[{ "type": "home", "number": "0203 544 1234" },{ "type": "office", "number": "01962 001234" }]
```

## 結(jié)果序列

## 序列扁平化

## 空序列和單例序列

### 頂層數(shù)組、嵌套數(shù)組和數(shù)組展平

考慮 JSON 文檔：

```
[
{ "ref": [ 1,2 ] },
{ "ref": [ 3,4 ] }
]
```

在頂層，我們有一個(gè)數(shù)組而不是一個(gè)對(duì)象。如果我們想選擇這個(gè)頂層數(shù)組中的第一個(gè)對(duì)象，我們沒(méi)有字段名稱來(lái)附加它 `[0]`。我們不能 `[0]` 單獨(dú)使用它，因?yàn)檫@與[數(shù)組構(gòu)造函數(shù)]() 語(yǔ)法沖突。但是，我們可以使用*上下文*引用 `$` 來(lái)引用文檔的開(kāi)頭，如下所示：

* `$` 表達(dá)式開(kāi)頭指的是整個(gè)輸入文檔

```
$[0] 
//結(jié)果
{ "ref": [ 1,2 ] }
```

* `.ref` 這里返回整個(gè)內(nèi)部數(shù)組

```
$[0].ref
 //結(jié)果
[ 1,2 ]
```

* 返回內(nèi)部數(shù)組第一個(gè)位置的元素

```
$[0].ref[0]
// 結(jié)果
1
```

* 盡管嵌套數(shù)組的結(jié)構(gòu)如此，但結(jié)果選擇仍會(huì)展平為單個(gè)平面數(shù)組。輸入數(shù)組的原始嵌套結(jié)構(gòu)已丟失。請(qǐng)參閱[數(shù)組構(gòu)造函數(shù)]()以了解如何在結(jié)果中保留原始結(jié)構(gòu)。

```
$.ref
//結(jié)果 
[ 1, 2, 3, 4 ]

```

1 、簡(jiǎn)單查詢

1 、簡(jiǎn)單查詢