我想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不兼容?
调试的想法,建议等,欢迎解决问题;)
1 回答
我实际上昨天弄清楚了 . 我将在本周的某个时间在git hub上发布一个示例应用程序,因为我无法在任何地方找到示例