合并 swagger 定义文件答案

【问题标题】：Combine swagger Definition files合并 swagger 定义文件
【发布时间】：2018-04-23 08:31:32
【问题描述】：

我正在通过注释源代码为我的所有 API 生成一个大张旗鼓的定义。

我想知道是否有任何方法可以将所有 API 合并到一个 json 文件中？

注意：我使用的是Swagger 2.0 定义。

【问题讨论】：

这个问题解决了吗？如果您可以在此处提供解决方案，它将对其他人/社区有所帮助。

【解决方案1】：

如果您使用在 server.xml 中定义的 apiDiscovery-1.0 特性将这些应用程序部署在 WebSphere Liberty 服务器中，那么您可以简单地进入 (GET) /ibm/api/docs 并检索您的聚合 JSON 文件。您还可以通过添加 Accept 标头“application/yaml”来将其检索为 YAML。

您可以在 wasdev.net 免费下载它，然后运行 installUtility 命令来获取该功能 (wlp/bin installUtility install apiDiscovery-1.0)。

【讨论】：

看起来很有趣。如果将两个swagger文件放在一个文件夹中，它可以合并为一个mater swagger json文件吗？
每个 swagger 文档必须在不同的 web 模块中（即在不同的 WAR 文件中），然后它们将组合成一个主 json 文件。这是 WebSphere Liberty 的 API 支持通过 apiDiscovery-1.0 特性实现的行为。