update mock json schema

Author: LinuxSuRen

docs/api-testing-mock-schema.json

@@ -10,18 +10,7 @@
         "properties": {
           "name": {"type": "string"},
           "initCount": {"type": "integer"},
-          "sample": {"type": "string"},
-          "fields": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "name": {"type": "string"},
-                "kind": {"type": "string"}
-              },
-              "required": ["name", "kind"]
-            }
-          }
+          "sample": {"type": "string"}
         },
         "required": ["name"]
       }
@@ -66,6 +55,17 @@
         "required": ["name", "request", "response"]
       }
     },
+    "proxies": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "path": {"type": "string"},
+          "target": {"type": "string"}
+        },
+        "required": ["path", "target"]
+      }
+    },
     "webhooks": {
       "type": "array",
       "items": {

docs/site/content/zh/latest/tasks/mock.md

@@ -122,7 +122,7 @@ curl http://localhost:6060/mock/api/v1/base64
 
 如果你的 Body 内容可以通过另外一个 HTTP 请求（GET）获得，那么你可以这么写：
 
-```
+```yaml
 #!api-testing-mock
 # yaml-language-server: $schema=https://linuxsuren.github.io/api-testing/api-testing-mock-schema.json
 items:
@@ -133,3 +133,21 @@ items:
       body: https://baidu.com
       encoder: url
 ```
+
+在实际情况中，往往是向已有系统或平台添加新的 API，此时要 Mock 所有已经存在的 API 就既没必要也需要很多工作量。因此，我们提供了一种简单的方式，即可以增加**代理**的方式把已有的 API 请求转发到实际的地址，只对新增的 API 进行 Mock 处理。如下所示：
+
+```yaml
+#!api-testing-mock
+# yaml-language-server: $schema=https://linuxsuren.github.io/api-testing/api-testing-mock-schema.json
+proxies:
+  - path: /api/v1/{part}
+    target: http://atest.localhost:8080
+```
+
+当我们发起如下的请求时，实际请求的地址为 `http://atest.localhost:8080/api/v1/projects`
+
+```shell
+curl http://localhost:6060/mock/api/v1/projects
+```
+
+> 更多 URL 中通配符的用法，请参考 https://github.com/gorilla/mux

docs/site/content/zh/latest/tasks/mock/simple.yaml

@@ -31,5 +31,5 @@ items:
       body: https://baidu.com
       encoder: url
 proxies:
-  - path: /api/v1/{point}
+  - path: /api/v1/{part}
     target: http://atest.localhost:8080

pkg/mock/in_memory.go

@@ -138,16 +138,13 @@ func (s *inMemoryServer) Load() (err error) {
 
 func (s *inMemoryServer) Start(reader Reader, prefix string) (err error) {
 	var handler http.Handler
-	if handler, err = s.SetupHandler(reader, prefix); err != nil {
-		return
-	}
-
-	if s.listener, err = net.Listen("tcp", fmt.Sprintf(":%d", s.port)); err != nil {
-		return
+	if handler, err = s.SetupHandler(reader, prefix); err == nil {
+		if s.listener, err = net.Listen("tcp", fmt.Sprintf(":%d", s.port)); err == nil {
+			go func() {
+				err = http.Serve(s.listener, handler)
+			}()
+		}
 	}
-	go func() {
-		err = http.Serve(s.listener, handler)
-	}()
 	return
 }
 

pkg/mock/types.go

@@ -16,15 +16,9 @@ limitations under the License.
 package mock
 
 type Object struct {
-	Name      string  `yaml:"name" json:"name"`
-	InitCount *int    `yaml:"initCount" json:"initCount"`
-	Sample    string  `yaml:"sample" json:"sample"`
-	Fields    []Field `yaml:"fields" json:"fields"`
-}
-
-type Field struct {
-	Name string `yaml:"name" json:"name"`
-	Kind string `yaml:"kind" json:"kind"`
+	Name      string `yaml:"name" json:"name"`
+	InitCount *int   `yaml:"initCount" json:"initCount"`
+	Sample    string `yaml:"sample" json:"sample"`
 }
 
 type Item struct {