Javascript 我真的需要创建swagger.json和swagger.yaml才能将swagger用于rest应用程序文档吗

Javascript 我真的需要创建swagger.json和swagger.yaml才能将swagger用于rest应用程序文档吗,javascript,rest,jersey,swagger,Javascript,Rest,Jersey,Swagger,我花了一整天的时间遵循Swagger指南,该指南基本上告诉我,在添加了Swagger依赖项并部署/启动它之后,我将获得两个文件,根据Swagger注释(例如@Api)的使用来描述我的rest服务。首先,不清楚这两个文件是在编译之后还是在某个特定阶段(部署到服务器、任何特定的maven阶段或目标,或者容器启动)创建的。好吧,如果我能够启动并运行它,这一点都不是问题(请参阅我的难点) 以前我尝试运行其他人提供的简单示例,而不是遵循官方的guidande,结果没有一个使用swagger.json和sw

我花了一整天的时间遵循Swagger指南,该指南基本上告诉我,在添加了Swagger依赖项并部署/启动它之后,我将获得两个文件,根据Swagger注释(例如@Api)的使用来描述我的rest服务。首先,不清楚这两个文件是在编译之后还是在某个特定阶段(部署到服务器、任何特定的maven阶段或目标,或者容器启动)创建的。好吧,如果我能够启动并运行它,这一点都不是问题(请参阅我的难点)

以前我尝试运行其他人提供的简单示例,而不是遵循官方的guidande,结果没有一个使用swagger.json和swagger.yaml

三个示例完全按照作者的承诺运行(为测试公开文档和特性): 1 - 2 - 3-

然而,它们中没有一个创建或似乎依赖于这两个文件。所以,我的直截了当的问题是:我真的需要这些文件来集成我当前的Rest服务应用程序来招摇过市吗

如果不是,作为补充,在不依赖这些文件的情况下,集成它的常见方法或方式是什么?我注意到这三个示例都有一些我遵循的官方招摇过市指南中没有描述的文件(例如Swagger-ui.js、Swagger-ui.min.js)。我知道这样的问题似乎很大。所以,为了缩小范围,我计划基于这三个示例的相同想法,使用backbone-min.js+swagger.js+下划线-min.js


注:我所说的官方指导,是指

不要问新的问题,你应该改进以增加获得答案的机会。埃米尔,它们根本不是同一个问题。您是否注意到,前面的版本被重新定义为部署到TomCat并启动applicationw,而这一版本的重点是swageer.json/yaml?除此之外,我清楚地提到了我对球衣兼容性的怀疑。