如何在node.js中使用swagger-autogen确定“属性”的顺序？

Question

由于某种原因，swagger-autogen 正在颠倒 swagger.json 输出文件中属性的顺序。例如，我有一个简单的“用户”猫鼬模式，仅包含“用户名”和“密码”属性。当我运行 swagger-autogen 时，我的 PUT swagger-docs 首先填充密码，最后填充用户名。我首先需要用户名，最后需要密码。每次运行 swagger-autogen 时，我都必须在 swagger.json 文件中手动修复它。有没有办法确定我的 swagger.js 中或可能的控制器函数中的属性顺序，这样我就不必每次都更改它？

Answer 1

swagger-autogen 没有确定参数顺序的选项。对于您的情况，您有两种选择：

选项 1：尝试重新排序您的猫鼬架构。

选项2：在包含

put

方法的端点中手动声明参数，如下：

app.put('/somepath', (req, res) => {

    /*  #swagger.parameters['body'] = {
            in: 'body',
            required: true,
            schema: {
                username: "user",
                password: "1234"
            }
    } */

    ...
})

在此处查看有关 swagger-autogen 参数的更多信息

如果这些选项都不起作用，请向我们发送示例项目的链接，或在此处发布一些重现此问题的代码片段。这样就更容易帮助您。

免责声明：
适用于 swagger v1、v2，但不适用于 v3