spring - Apache CXF：REST API 文档

Question

我们使用 Apache CXF 和 Spring 来开发 Web 服务应用程序。有没有办法仅使用内置注释将应用程序中的所有端点生成为文档？

我正在寻找类似rake routesRails 世界的东西；）

Answer 1

CXF 可以自动生成一个服务列表，其中包含指向WADL文件的链接，描述您的 Web 服务。

默认情况下，如果您有一个 REST Web 服务公开在

http://host/path

即将

http://host/path/services

应该给你那个服务列表。

要直接获取 WADL 文档，只需将其添加?_wadl到 REST 服务器的挂载位置即可。此路径及其子路径上可用的所有操作和方法都应记录在此处。

请参阅http://cxf.apache.org/docs/jaxrs-services-description.html（特别是“服务列表和 WADL 查询”部分）。