Can I use multiple @throws tags for the same excep

问题:

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.