使用Swagger的CXF REST API文档

Question

根据Swagger的教程，似乎swagger仅支持Jersey框架（参见https://github.com/wordnik/swagger-core/wiki/java-jax-rs）

是否有人在实施CXF JAX-RS时有过摇摆不定的工作经验？你能在这里分享你的建议吗？

Answer 1

是的，可以使用Swagger和swagger-jaxrs_2.10模块实现CXF JAX-RS实现。

在CXF环境中使用Swagger需要一些可以通过Spring应用程序上下文完成的特定配置。

以下是此类配置的良好tutorial和example。

Answer 2

是的，可以在Apache CXF上使用swagger。以下是我工作API中的招摇用法。

@GET
    @Path("/version")
    @Produces(MediaType.APPLICATION_JSON)
    @ApiOperation(value = "For paged fetches returns a version for future fetches")
    public long version(@Context HttpHeaders headers) {
        return ABC.version();
    }