我正在尝试configure an existing application使用Swagger。该应用程序使用Resteasy 3和Jetty 9.2以及JAX-RS 3。
我的更改基于explanations given on the Swagger wiki。
我首先在我的build.gradle中添加了swagger 1.5.0,然后在名为 SchedulerStateRest 的资源上添加注释@Api和@ApiOperation。
下一步是修改我的web.xml,以hook up Swagger-Core in my Application和Initialize Swagger using Swagger's Servlet。
我的问题是,当我启动应用程序时,当我从http://localhost:8080浏览/swagger.json
或/swagger.yaml
时,找不到任何资源。但是,启动Jetty并且现有服务正在运行且可用时,我没有收到任何错误。
我有enabled Jetty logs但我没有找到与我相关的信息(启动Jetty的负责人是JettyStarter)。
通过查找类似的问题,我发现有人说在/ v1 / api-docs上应该提供swagger内容,所以我尝试了不同的URL,但我总是遇到404错误。
最近,我找到了gist from ben-manes用于配置Resteasy 3 + Guice 4的swagger。我试图模仿它的配置并基于Guice-servlet解释推断出web.xml的配置但我最终得到了相同的结果。上面解释的配置问题(没有可用的资源是预期的地址)。
由于启动嵌入式Jetty时没有错误,我想知道问题是否与错误的地址无关。您知道如何列出Jetty实例上可用的“资源”吗?
我注意到Swagger维基上的解释是针对Resteasy 2.X.这是否意味着Swagger与Resteasy 3.x不兼容?
调试的想法,建议等,欢迎解决问题;)
答案 0 :(得分:2)