@4geit/swg-todo-model 中文文档教程

Question

@4geit/swg-todo-model

---

model

Installation

1. A recommended way to install @4geit/swg-todo-model is through npm package manager using the following command:

npm i @4geit/swg-todo-model --save

或使用 yarn 使用以下命令：

yarn add @4geit/swg-todo-model

2. In your swagger file, you need to add a reference to the SwgTodoModel definition under the definitions property (e.g. /api/swagger/swagger.yaml) as below:

swagger: "2.0"
# ...
definitions:
  SwgTodoModel:
    $ref: ../../node_modules/@4geit/swg-todo-model/swagger.yaml#/definitions/SwgTodoModel
# ...

3. SwgTodoModel also comes along with some endpoints you can expose to the API, to do so you will need to add a reference to the SwgTodoModel definition under the paths property (e.g. /api/swagger/swagger.yaml) as below:

swagger: "2.0"
# ...
paths:
  /todos:
    $ref: ../../node_modules/@4geit/swg-todo-model/swagger.yaml#/definitions/TodoListPath
  /todos/bulk:
    $ref: ../../node_modules/@4geit/swg-todo-model/swagger.yaml#/definitions/TodoBulkPath
  /todos/{id}:
    $ref: ../../node_modules/@4geit/swg-todo-model/swagger.yaml#/definitions/TodoItemPath
  /todos/populate:
    $ref: ../../node_modules/@4geit/swg-todo-model/swagger.yaml#/definitions/PopulatePath
# ...

您还需要将路径添加到 swg-todo-model 的 controllers 文件夹package 这样 swagger-node 就会找到相关的控制器来使用。 编辑文件 /config/default.yaml 并向属性 mockControllersDirs 和 controllersDirs 添加两个新路径，如下所示：

swagger:
  # ...
  bagpipes:
    _router:
      # ...
      mockControllersDirs:
        # ...
        - node_modules/@4geit/swg-todo-model/mocks
        # ...
      controllersDirs:
        # ...
        - node_modules/@4geit/swg-todo-model/controllers
        # ...