jax-doclets
jax-doclets copied to clipboard
@FORM annotated parameter documented as String
We are using jax-doclets to generate documentation from Java code and RESTeasy. Noticed that @Form annotated parameters appear as String in the generated documentation. For example:
@GET ResponseObjectClass someMethod(@Form RequestObjectClass request) { ... }
appears as:
Input: String
Output: ResponseObjectClass
in the generated documentation.
On page http://fromage.github.com/jax-doclets/docs/0.10.0/html/index.html is said: "3.5 Supported RESTEasy JAX-RS extension annotations
If the optional RESTEasy dependency is present, the following RESTEasy annotations are supported on resource methods or classes:
@Form"
and we tried to add this optional RESTeasy dependency in the pom.xml, several times, at different places in the pom.xml - inside the
Can you please give an example how and where the optional RESTeasy dependency should be used in order to generate proper documentation for a @Form annotated parameter object.
Thank you. Regards
The test in https://github.com/FroMage/jax-doclets/blob/master/doclets/src/test/java/com/lunatech/doclets/jax/test/FormTest.java uses it (see http://fromage.github.com/jax-doclets/examples/jaxrsdocs/form-%7Bid%7D/index.html for output) without issues. Check the pom at https://github.com/FroMage/jax-doclets/blob/master/doclets/pom.xml for comparison