Dev Book Review/Effective Java
2020. 5. 5.
[Effective Java] item 19. 상속을 고려해 설계하고 문서화하라. 그렇지 않았다면 상속을 금지하라
1. 재정의 메서드의 문서화 상속용 클래스는 재정의할 수 있는 메서드들을 내부적으로 어떻게 이용하는지(자기사용) 문서로 남겨야한다. 재정의 가능 메서드 : 호출 메서드의 API 설명에 기술, 호출 순서, 각각의 호출 결과 처리 영향 기술 호출할 수 있는 모든 상황을 남긴다. 백그라운드 스레드, 정적 초기화 과정에서 호출이 일어날 수 있는 상황 등 API 문서의 Implementation Requirements : 메서드의 내부 동작 방식 설명 메서드 주석에 @ImplSpec 태그를 붙여주면 자바독 도구가 생성된다. 좋은 API문서란 '어떻게'란 '무엇'을 하는지를 설명해야한다. 대치된다 : 그러나 상속이 캡슐화를 해치기 때문에 어쩔수 없다 - 클래스를 안전하게 상속할 수 있게 해야하기 때문 2. 상속 설..