用于JAX-RS服务的Javadocs

Question

JAX-RS注释Path，GET，POST，PUT和DELETE没有@Documented，因此它们不会出现在javadoc中。这些注释出现在javadoc中非常有用，因为它们会告诉你调用的路径和HTTP方法。有谁知道如何让这些信息出现在javadocs中？

Answer 1

通常，RESTful部分超出了javadoc的范围。您所描述的内容通常由WADL处理。 Jax-rs includes support for generating WADL's。原因是非Java代码可能想要使用您的Web服务，因此最好使用非基于Java的规范。