[Effective-Java] Chapter10 #74. 메서드가 던지는 모든 예외를 문서화하라
·
Reference/Effective-Java
1️⃣ 검사 예외는 항상 따로따로 선언하고, 각 예외가 발생하는 상황을 @throws 태그로 정확히 문서화하라 공통 상위 클래스(Exception, Throwable)로 뭉뚱그려 선언하는 일은 삼가하라 메서드 사용자에게 대처할 힌트를 주지 못한다. 같은 맥락에서 발생할 여지가 있는 다른 예외까지 삼켜버릴 수 있다. main 메서드는 오직 JVM만이 호출하므로 Exception을 던져도 괜찮은 유일한 예다. 비검사 예외도 검사 예외처럼 문서화 해두면 좋다. 자신이 일으킬 수 있는 오류들을 알림으로써 프로그래머가 해당 오류가 나지 않도록 코딩하게 돕는다. 사실상 해당 메서드를 성공적으로 수행하기 위한 전제조건이 된다. 인터페이스 메서드의 경우 해당 조건이 일반 규약에 속하게 되어, 모든 구현체가 일관되게 동..