Swagger with Resteasty 3 + Jetty 9.2 + JAX-RS 3

时间:2015-07-12 14:29:15

标签: jetty jax-rs resteasy swagger

我正在尝试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 ApplicationInitialize 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 个答案:

答案 0 :(得分:2)

实际上,我昨天已经弄明白了。我将在本周的某个时间在git hub上发布一个示例应用程序,因为我无法在任何地方找到示例