自动生成API文档

Question

我是一个初级Java开发人员，最近一直在做一个大项目。其中一部分是使用Jersey为第三方客户端创建RESTful网络服务。现在，在完成项目后，我的任务是记录所有的web服务调用(我知道我应该从一开始就开始)，有没有什么简单的工具/Eclipse插件可以自动生成API文档，而不会有太多麻烦？

Answer 1

我已经使用了enunciate，它解析您的服务类的javadoc和JAX-RS注释以生成文档：

https://github.com/stoicflame/enunciate/wiki

有一个可以工作的maven插件，well.It还可以生成各种语言的客户端库以及基于xml的服务的示例xml。