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

Question

Can I use multiple @throws javadoc tags if my application throws the same exception for multiple reasons? For example:

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

Is it prohibited by JavaDoc standard?

Answer 1

It is valid in java 6,7 and 8. See the docs:

• Javadoc 6
• Javadoc 7
• Javadoc 8

Multiple @throws tags can be used in a given doc comment for the same or different exceptions.

(emph. mine)

Answer 2

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