是否有类似javadoc的工具可以从JAX-RS注释生成RESTful web服务apidoc?

是否有类似javadoc的工具可以从JAX-RS注释生成RESTful web服务apidoc?,java,rest,documentation,jax-rs,Java,Rest,Documentation,Jax Rs,我正在使用资源上的JAX-RS注释,用CXF开发一个web服务。这些注释指定参数名称、默认值以及有效的输入和输出mime类型 能够在我的代码上运行一个javadoc风格的工具来生成这个接口的一组简明文档是很好的,但是我似乎找不到任何东西 javadoc本身生成的文档需要进行太多的裁剪,我真的希望能够理解JAX-RS注释的语义,并生成一些对想要使用我的服务的开发人员友好的文档。如果您正在构建Restful Web服务,那么该文档称为。WADL基本上是Rest版本的WSDL。我用它来构建我的Rest

我正在使用资源上的JAX-RS注释,用CXF开发一个web服务。这些注释指定参数名称、默认值以及有效的输入和输出mime类型

能够在我的代码上运行一个javadoc风格的工具来生成这个接口的一组简明文档是很好的,但是我似乎找不到任何东西


javadoc本身生成的文档需要进行太多的裁剪,我真的希望能够理解JAX-RS注释的语义,并生成一些对想要使用我的服务的开发人员友好的文档。

如果您正在构建Restful Web服务,那么该文档称为。WADL基本上是Rest版本的WSDL。我用它来构建我的Restful web服务。Jersey会根据资源包中的注释自动创建WADL。以下是泽西岛网站上的WADL示例:

最棒的是你什么都不做当您更改
资源
类中的URI或参数注释时,它们将自动反映在此文档中


塔达!:)

看一看。有一个可以生成站点中包含的文档的工具。

Nice!Maven集成-我在.Nice中,只是它不支持多个@FormDataParam参数。谢谢链接。我没有听说过WADL,所以这很有帮助,但我真的在寻找人类可读的东西。有用于将WADL转换为HTML的XSLT样式表,例如如何告诉Jersey@GET(/foo)表示“检索业务对象栏”,而@QueryParam(name=“bla”)表示“以毫秒为单位提供开始日期”)?