@4geit/swg-hello-path 中文文档教程

发布于 7年前 浏览 16 项目主页 更新于 3年前

@4geit/swg-hello-path npm version


添加一个在你的 api 中启用 hello world 端点的虚拟路径

Installation

  1. A recommended way to install @4geit/swg-hello-path is through npm package manager using the following command:
npm i @4geit/swg-hello-path --save

或者使用 yarn 使用以下命令:

yarn add @4geit/swg-hello-path
  1. In your swagger file, you need to add a reference to the SwgHelloPath definition under the paths property (e.g. /api/swagger/swagger.yaml) as below:
swagger: "2.0"
# ...
paths:
  /hello:
    $ref: ../../node_modules/@4geit/swg-hello-path/swagger.yaml#/definitions/SwgHelloPath
# ...

你还需要将路径添加到 controllers 文件夹swg-hello-path 包,这样 swagger-node 就会找到相关的控制器来使用。 编辑文件 /config/default.yaml 并向属性 mockControllersDirscontrollersDirs 添加两个新路径,如下所示:

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

@4geit/swg-hello-path npm version


add a dummy path that enables an hello world endpoint in your api

Installation

  1. A recommended way to install @4geit/swg-hello-path is through npm package manager using the following command:
npm i @4geit/swg-hello-path --save

Or use yarn using the following command:

yarn add @4geit/swg-hello-path
  1. In your swagger file, you need to add a reference to the SwgHelloPath definition under the paths property (e.g. /api/swagger/swagger.yaml) as below:
swagger: "2.0"
# ...
paths:
  /hello:
    $ref: ../../node_modules/@4geit/swg-hello-path/swagger.yaml#/definitions/SwgHelloPath
# ...

And you will also need to add the path to the controllers folder of the swg-hello-path package so that swagger-node will find the relevant controller to use. Edit the file /config/default.yaml and add two new paths to the properties mockControllersDirs and controllersDirs as illustrated below:

swagger:
  # ...
  bagpipes:
    _router:
      # ...
      mockControllersDirs:
        # ...
        - node_modules/@4geit/swg-hello-path/mocks
        # ...
      controllersDirs:
        # ...
        - node_modules/@4geit/swg-hello-path/controllers
        # ...
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文