求推荐非Spring Boot的Java EAR应用API文档自动生成工具

下面是几个适配传统Java EE EAR应用的实用方案，均不依赖Spring Boot：

• Swagger Core（OpenAPI Core）
  作为OpenAPI规范的官方实现，完美支持JAX-RS（Jersey、RESTeasy等常用框架）。只需添加对应依赖，在JAX-RS资源类/方法上标注@OpenAPIDefinition、@Operation等注解，配置好接口扫描路径后，就能自动生成OpenAPI 3.x规范的JSON/YAML文档，还可搭配Swagger UI组件实现浏览器端的可视化文档展示。

• Apache CXF JAX-RS Documentation
  如果你使用Apache CXF作为JAX-RS的实现框架，它自带了文档生成模块。通过配置CXF的扩展组件，可直接从JAX-RS资源类生成HTML格式的接口文档，也能导出为OpenAPI规范。配置流程和CXF的服务发布深度整合，无需额外引入大量第三方依赖。

• RestDoclet
  基于JavaDoc的静态文档生成工具，完全在编译阶段完成文档生成，无运行时依赖。通过自定义JavaDoc标签（如@api、@apiParam）或结合JAX-RS原生注解，直接从代码注释和类结构生成静态HTML文档，适合对运行时性能有要求的传统Java EE应用。

• RAML相关工具
  若采用API优先的开发模式，可先通过RAML规范定义接口，再借助raml-java-parser等工具反向生成JAX-RS代码；如果是代码优先的场景，也有对应插件支持从JAX-RS资源类提取信息生成RAML格式的文档，适配Java EE生态。

内容的提问来源于stack exchange，提问作者Rubén Aguado