Czy mogę używać wielu tagów @throws dla tego samego wyjątku w Javadoc?

Question

Czy mogę używać wielu zmiennych javadoc @throws, jeśli moja aplikacja zgłasza ten sam wyjątek z wielu powodów? Na przykład:

@throws UserException if issue 1 happened 
@throws UserException if issue 2 happened 
@throws UserException if issue 3 happened 

Czy jest zabronione przez standard JavaDoc?

Answer 1

Jest ważny w java 6,7 ​​i 8. Zobacz docs:

• Javadoc 6
• Javadoc 7
• Javadoc 8

Wiele @throws znaczniki mogą być używane w dany komentarz do dokumentu dla tego samego lub innych wyjątków.

(emph. Kopalnia)

Answer 2

tylko przetestowane wygenerowany JavaDoc zawiera wszystkie 3 @throws.