使用 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.
相关文章