19
Estoy desarrollando un servicio web con CXF mediante el uso de anotaciones JAX-RS en recursos. Estas anotaciones especifican nombres de argumentos, valores predeterminados y los tipos válidos de mime de entrada y salida.¿Existen herramientas tipo javadoc para generar apdoc de servicio web RESTful a partir de anotaciones JAX-RS?
Sería bueno poder ejecutar una herramienta javadoc-esque en mi código para generar un conjunto conciso de documentación de esta interfaz, pero parece que no puedo encontrar nada.
Los documentos producidos por javadoc requerirían demasiado recorte, realmente quiero algo que entienda la semántica de las anotaciones JAX-RS y genere algo amigable para los desarrolladores que quieran usar mi servicio.
Gracias por los enlaces. No había oído hablar de WADL, así que eso ayudó, pero realmente estaba buscando algo legible para los humanos. Existen hojas de estilo XSLT para transformar WADL en HTML, como https://github.com/mnot/wadl_stylesheets –
¿Cómo le dice a Jersey que @GET (/ foo) significa "recuperar la barra de objetos comerciales" y @QueryParam (nombre = "bla") significa "Proporcionar fecha de inicio en milisegundos"? –