Ste*_*eed 19 java documentation rest jax-rs
我正在通过在资源上使用JAX-RS注释来开发使用CXF的Web服务.这些注释指定参数名称,默认值以及有效的输入和输出MIME类型.
能够在我的代码上运行一个javadoc-esque工具来生成这个接口的简明文档集是很好的,但我似乎找不到任何东西.
由javadoc本身生成的文档需要进行过多的修改,我真的想要了解JAX-RS注释的语义,并为想要使用我的服务的开发人员生成一些友好的东西.
如果要构建Restful Web服务,则文档称为WADL.WADL基本上是Rest的WSDL版本.我使用Jersey来构建我的Restful Web服务.Jersey会根据资源包中的注释自动创建WADL.以下是泽西网站上的样本WADL:https: //java.net/projects/jersey/sources/svn/show/trunk/jersey/samples/generate-wadl
最好的部分是你什么都不做.:)当您更改类中的URI或参数注释时Resource,它们将自动反映在本文档中.
TADAA!:)