我刚刚开始使用 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 {
}
生成
同时
@WebServlet
/**
* My javadoc
* <br>25/08/2014
*/
public class MyServlet {
}
生成
我使用的是 Java 7。
如果您只是想让 javadoc 位于源代码中方法声明的正上方,您仍然可以尝试
/**
* My javadoc
* <br>25/08/2014
*/
@WebServlet public class MyServlet {
}
这将生成
关于java - @WebServlet 注释似乎会干扰 javadoc。有一个简单的解决方法吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/25493177/