使用 swagger 或任何其他工具生成 Rest API 文档

我正在寻找一种方法来记录我的 Rest API.我的服务器是 Tomcat/Spring 服务器,其余 API 使用 Jenkins 实现.

I am looking for a way to document my Rest APIs. My server is a Tomcat/Spring server and the Rest APIs are implemented using Jenkins.

Swagger 似乎是一个非常酷的解决方案,但我不知道如何在我的代码中使用它.我正在寻找创建 json swagger-ui 可以读取的最佳方法 - 我应该怎么做?

Swagger seems to be a pretty cool solution but i can't figure out how i can use it with my code. I am looking for the best way to create the json swagger-ui can read - how i should do that?

另外,我很乐意检查在这种环境中记录 Rest API 的任何其他好的解决方案.

Also, i would be happy to check any other good solutions for documenting Rest APIs in such environment.

推荐答案

swagger我没试过,你可以试试enunciate.它可以生成 JAX-RS 端点的文档作为 javadoc 阶段的一部分.enunciate page

I haven't tried swagger but you may try enunciate. It can generate documentation of JAX-RS endpoints as a part of javadoc phase. Some examples of generated documentation are available on enunciate page

更新

项目已移至 http://enunciate.webcohesion.com/,将支持 java 8通过即将发布的 2.0 版.

Project has been moved to http://enunciate.webcohesion.com/, java 8 will be supported by upcoming version 2.0.

相关文章