java - Javadoc で同じ例外に複数の @throws タグを使用できますか?

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. mine)

Answer 2

これをテストしたところ、生成された JavaDoc には 3 つの @throws がすべて含まれています。