k8smeetup-rootsongjc-pr-20170915

2017-09-30 16:35:22 +08:00
parent 5740df35cf
commit e9b11a71ab
25 changed files with 3084 additions and 0 deletions
@@ -0,0 +1,100 @@
+---
+title: JSONPath 支持
+cn-approvers:
+- rootsongjc
+cn-reviewers:
+- rootsongjc
+---
+
+<!--
+
+JSONPath template is composed of JSONPath expressions enclosed by {}.
+And we add three functions in addition to the original JSONPath syntax:
+
+-->
+
+JSONPath 模板由 {} 包起来的 JSONPath 表达式组成。
+除了原始的 JSONPath 语法之外，我们还添加了三个函数：
+
+<!--
+
+1. The `$` operator is optional since the expression always starts from the root object by default.
+2. We can use `""` to quote text inside JSONPath expressions.
+3. We can use `range` operator to iterate lists.
+
+The result object is printed as its String() function.
+
+Given the input:
+
+-->
+
+1. `$` 运算符是可选的，因为表达式默认情况下始终从根对象开始。
+2. 我们可以使用 `""` 来引用 JSONPath 表达式中的文本。
+3. 我们可以使用 `range` 运算符来迭代列表。
+
+结果对象使用 String() 函数打印。
+
+给定输入：
+
+```json
+{
+  "kind": "List",
+  "items":[
+    {
+      "kind":"None",
+      "metadata":{"name":"127.0.0.1"},
+      "status":{
+        "capacity":{"cpu":"4"},
+        "addresses":[{"type": "LegacyHostIP", "address":"127.0.0.1"}]
+      }
+    },
+    {
+      "kind":"None",
+      "metadata":{"name":"127.0.0.2"},
+      "status":{
+        "capacity":{"cpu":"8"},
+        "addresses":[
+          {"type": "LegacyHostIP", "address":"127.0.0.2"},
+          {"type": "another", "address":"127.0.0.3"}
+        ]
+      }
+    }
+  ],
+  "users":[
+    {
+      "name": "myself",
+      "user": {}
+    },
+    {
+      "name": "e2e",
+      "user": {"username": "admin", "password": "secret"}
+    }
+  ]
+}
+```
+<!--
+| Function          | Description               | Example                                  | Result                                   |
+| ----------------- | ------------------------- | ---------------------------------------- | ---------------------------------------- |
+| text              | the plain text            | kind is {.kind}                          | kind is List                             |
+| @                 | the current object        | {@}                                      | the same as input                        |
+| . or []           | child operator            | {.kind} or {['kind']}                    | List                                     |
+| ..                | recursive descent         | {..name}                                 | 127.0.0.1 127.0.0.2 myself e2e           |
+| *                 | wildcard. Get all objects | {.items[*].metadata.name}                | [127.0.0.1 127.0.0.2]                    |
+| [start:end :step] | subscript operator        | {.users[0].name}                         | myself                                   |
+| [,]               | union operator            | {.items[*]['metadata.name', 'status.capacity']} | 127.0.0.1 127.0.0.2 map[cpu:4] map[cpu:8] |
+| ?()               | filter                    | {.users[?(@.name=="e2e")].user.password} | secret                                   |
+| range, end        | iterate list              | {range .items[*]}[{.metadata.name}, {.status.capacity}] {end} | [127.0.0.1, map[cpu:4]] [127.0.0.2, map[cpu:8]] |
+| ""                | quote interpreted string  | {range .items[*]}{.metadata.name}{"\t"}{end} | 127.0.0.1    127.0.0.2                   |
+-->
+| 函数                | 描述         | 示例                                       | 结果                                       |
+| ----------------- | ---------- | ---------------------------------------- | ---------------------------------------- |
+| text              | 纯文本        | kind is {.kind}                          | kind is List                             |
+| @                 | 当前对象       | {@}                                      | 与输入相同                                    |
+| . or []           | 子运算符       | {.kind} 或者 {['kind']}                    | List                                     |
+| ..                | 递归下降       | {..name}                                 | 127.0.0.1 127.0.0.2 myself e2e           |
+| *                 | 通配符，获取所有对象 | {.items[*].metadata.name}                | [127.0.0.1 127.0.0.2]                    |
+| [start:end :step] | 下标运算符      | {.users[0].name}                         | myself                                   |
+| [,]               | 并集运算符      | {.items[*]['metadata.name', 'status.capacity']} | 127.0.0.1 127.0.0.2 map[cpu:4] map[cpu:8] |
+| ?()               | 过滤         | {.users[?(@.name=="e2e")].user.password} | secret                                   |
+| range, end        | 迭代列表       | {range .items[*]}[{.metadata.name}, {.status.capacity}] {end} | [127.0.0.1, map[cpu:4]] [127.0.0.2, map[cpu:8]] |
+| ""                | 引用解释执行字符串  | {range .items[*]}{.metadata.name}{"\t"}{end} | 127.0.0.1    127.0.0.2                   |