自动生成API文档

Question

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

Answer 1

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

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

有一个maven插件运行良好。它还可以生成各种语言的客户端库以及基于xml的服务的xml示例。