java - @WebServlet 注释似乎会干扰 javadoc。有一个简单的解决方法吗？

Question

我刚刚开始使用 javadoc 工具为包含 servlet 类的包创建文档。除了 servlet 之外，每个类都按预期工作，其中不显示说明。

经过反复试验，我将原因缩小到我用来声明 Tomcat servlet 的 @WebServlet 注释。如果可以避免的话，我宁愿不删除这个注释。我可以使用简单的解决方法吗？

这是我的代码的相关部分:

import javax.servlet.annotation.WebServlet;
@WebServlet("/MyServlet")

/**
* MyServlet description
*
* @author   ViscountRandom
* @since    2014-08-26
*/
public class MyServlet extends HttpServlet {
...

可以看到生成的javadoc页面here (请注意，缺少说明，并且 @WebServlet 注释出现在类名称上方)。

预先感谢您提供的任何帮助。

编辑:我尝试在代码中重新定位注释，但没有效果。

Answer 1

对我来说，它似乎有效，请参阅

/**
 * My javadoc
 * <br>25/08/2014
 */
@WebServlet
public class MyServlet {

}

生成

同时

@WebServlet

/**
 * My javadoc
 * <br>25/08/2014
 */
public class MyServlet {

}

生成

我使用的是 Java 7。

如果您只是想让 javadoc 位于源代码中方法声明的正上方，您仍然可以尝试

/**
 * My javadoc
 * <br>25/08/2014
 */
@WebServlet public class MyServlet {

}

这将生成