我可以在Javadoc中为同一个异常使用多个@throws标记吗？

Question

如果我的应用程序出于多种原因抛出相同的异常，我可以使用多个@throws javadoc标记吗？例如：

@throws UserException if issue 1 happened
@throws UserException if issue 2 happened
@throws UserException if issue 3 happened

JavaDoc标准是否禁止它？

Answer 1

在java 6,7和8中有效。请参阅文档：

• Javadoc 6
• Javadoc 7
• Javadoc 8

  

对于相同的或不同的例外情况，可以在给定的文档评论中使用多个@throws标记。

（emph.mine）

Answer 2

刚测试了这个，生成的JavaDoc包含了所有3个@throws。