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

标签 java servlets annotations javadoc

我刚刚开始使用 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 注释出现在类名称上方)。

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

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

最佳答案

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

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

}

生成

enter image description here

同时

@WebServlet

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

}

生成

enter image description here

我使用的是 Java 7。

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

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

}

这将生成

enter image description here

关于java - @WebServlet 注释似乎会干扰 javadoc。有一个简单的解决方法吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/25493177/

相关文章:

java - MongoDB,Java,按第一个数组条目排序

java - 静态变量在 Apache tomcat servlet 实例化中没有得到更新

javascript - 处理 Servlet 和 HTML 页面之间的函数调用和数据传输的最佳方式是什么

java - 使用注释时加入子类的未知实体问题

java - Java 注释中较少详细的枚举用法

java - 使用 Selenium Webdriver 查找并切换到正确的框架

java - 等待 CompletableFuture 完成,然后返回不同的值?

html - 如何从 Java servlet 访问 HTML 表单名称?

Java:通过注释检查列表中是否存在属性值

java - JPA如何在不创建表的情况下查询数据库