如何从任何自定义输入生成Swagger 2.0 Json？

Question

我正在寻找从我的自定义json api元数据生成swagger 2.0 json。

我注意到当输入是JAX-RS或Spring（Swagger Maven Plugin ）时可以实现这一点。但我想从我的自定义JSON输入中获取swagger json。

Answer 1

为BBC's Nitro API执行此操作时，我使用了创建不变的Swagger样板文件作为字符串的组合，我使用JSON.parse（）将其转换为JSON对象，然后简单地遍历源API规范JSON将各种属性附加到Swagger对象的对象。请参阅initSwagger（）函数以及在链接示例中将属性添加到swagger对象的方式。

然后我用JSON.stringify（）序列化Swagger对象以保存JSON格式的Swagger文档。

另一种方法是使用转换（如JSONT或许多正则表达式）将源API JSON转换为Swagger对象，具体取决于源规范与Swagger处理方式的映射程度。