Могу ли я использовать несколько тегов @throws для одного и того же исключения в Javadoc?

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. мой)

Answer 2

Только что проверил это, сгенерированный JavaDoc содержит все 3 @throws.