POST参数未收到Swagger3.0/OpenAPI

Question

我正在使用Swagger 3.0/OpenAPI编写一个网站来描述我的API和Node。js用于后端。我成功地完成了GET请求，但我在处理所有POST请求时遇到了一些问题。问题是，我在执行POST请求时从HTML表单提供的参数似乎没有被/controllers文件夹中Swagger处理程序自动生成的参数接收。尤其是req.招摇。params数组和req.swagger。params['body']是HTTP请求对象的子字段，应该包含参数，但始终为空。

我尝试使用“应用程序/x-www-表单-乌伦编码”和“应用程序/json”作为内容类型；我尝试了不同的来源来执行请求，例如SwaggerUI、Postman、前端网页和CURL；我尝试了FetchAPI和JQuery AJAX（$. post和$. ajax）。

这是我在注册.js中执行 POST 请求的方式：

event.preventDefault();

var firstname = $('#inputFirstname').val();
var lastname = $('#inputLastname').val();
var email = $('#inputEmail').val();
var psw = $('#inputPassword').val();

var data = {
    'firstname': firstname,
    'lastname': lastname,
    'email': email,
    'password': psw
};

$.ajax({
    url: '/user/register',
    type: 'POST',
    dataType: 'text', // also tried json
    contentType: 'application/x-www-form-urlencoded', //also tried json
    data: data
       }
)
 .done(successScreen)
 .fail(() => console.log('Fail'));

以下是我在swagger.yaml中描述我的API的方式：

(...)
/user/register:
    post:
      tags:
      - user
      summary: Create a new user.
      description: Register into the store.
      operationId: userRegisterPOST
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/RegisterBody'
      responses:
        201:
          description: succesfull registration
          content: {}
      x-swagger-router-controller: User
(...)
RegisterBody:
      required:
      - email
      - firstname
      - lastname
      - password
      type: object
      properties:
        email:
          type: string
        password:
          type: string
        firstname:
          type: string
        lastname:
          type: string

下面是 /controllers/User.js 中自动生成的处理程序，用于 /user/register 上的 POST 请求：

49:module.exports.userRegisterPOST = function userRegisterPOST (req, res){
50:  var body = req.swagger.params['body'].value; // here it's where I get the error, but it's auto-generated code
51:  User.userRegisterPOST(body)
52:    .then(function (response) {
53:      utils.writeJson(res, response);
54:    })
55:    .catch(function (response) {
56:      utils.writeJson(res, response);
57:    });
58:};

我得到的错误是：

TypeError: Cannot read property 'value' of undefined
    at userRegisterPOST (/.../controllers/User.js:50:41)
    at swaggerRouter (/.../node_modules/oas3-tools/middleware/swagger-router.js:388:20)
    at Layer.handle [as handle_request] (/.../node_modules/express/lib/router/layer.js:95:5)
    at trim_prefix (/.../node_modules/express/lib/router/index.js:317:13)
    at /.../node_modules/express/lib/router/index.js:284:7
    at Function.process_params (/.../node_modules/express/lib/router/index.js:335:12)
    at next (/.../node_modules/express/lib/router/index.js:275:10)
    at /.../node_modules/oas3-tools/middleware/swagger-validator.js:388:30
    at /.../node_modules/async/dist/async.js:1140:9
    at /.../node_modules/async/dist/async.js:473:16
    at eachOfArrayLike (/.../node_modules/async/dist/async.js:1057:9)
    at eachOf (/.../node_modules/async/dist/async.js:1117:5)
    at _asyncMap (/.../node_modules/async/dist/async.js:1133:5)
    at Object.map (/.../node_modules/async/dist/async.js:1122:16)
    at swaggerValidator (/.../node_modules/oas3-tools/middleware/swagger-validator.js:358:15)
    at Layer.handle [as handle_request] (/.../node_modules/express/lib/router/layer.js:95:5)

我应该在req.swagger.params['body']中找到参数。对于所有GET请求，值。

Answer 1

您可以继续使用 Swagger 的界面来创建您的 API，但不要从那里创建您的源代码。

将“swagger.yaml”文件保存到项目的文件夹中，例如“C：\myProject”，然后键入：

oas-generator swagger.yaml myproject

安装绿洲发电机：

npm install oas-generator -g

重要提示：仔细阅读文档：https://github.com/isa-group/oas-tools

更强大的OAS 2.x/3.x生成器:https://github.com/OpenAPITools/openapi-generator

Answer 2

最后，我解决了从“oas3-tools”切换到“oas-tools”（https://github.com/isa-group/oas-tools）来管理OpenAPI 3.0 API的问题。有了这个新的节点模块，我能够在 req.body 中检索 POST 参数。