我正在寻找一种方法来在javadoc模板中包含未经检查的异常的@throws参数。 我注意到在官方的java文档中他们总是记录在案,即使在这个Netbeans guidelines page他们也提到它是一个很好的编程实践:
禁止在Javadoc中提及未经检查的异常。
Nebehless在Netbeans编辑器中,这些异常没有添加到生成的javadoc中的@throws列表中 - 我尝试使用这个非常简单的代码:
public void method() {
throw new IllegalArgumentException();
}
为它生成的javadoc为空。
我发现自定义javadoc的解决方案是this answer中描述的解决方案,但是我无法找到一种方法来包含"动态"对于未经检查的异常,像@throws子句这样的内容就在我的情况下。
我还从Netbeans wiki中找到了this link,它解释了如何添加新的自定义变量以在模板中使用,但同样,我无法看到如何使用它来动态地包含@throws for unchecked正在记录的方法中使用的例外情况。