Can I use multiple @throws tags for the same exception in Javadoc?

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

Just tested this the generated JavaDoc contains all 3 @throws.