问题
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?
回答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)
回答2:
Just tested this the generated JavaDoc contains all 3 @throws.
来源：https://stackoverflow.com/questions/9229991/can-i-use-multiple-throws-tags-for-the-same-exception-in-javadoc