이 글을 보고 많이 참고하여 글을 작성합니다.

상속용 클래스가 지켜야 할 것들

재정의 할 수 있는 메서드들은 내부적으로 어떻게 이용하는지 문서화 하기

• 어떤 순서로 호출하는지, 호출 결과가 이어지는 처리에 어떤 영향을 주는지 담기
• 재정의 가능 메서드란 public, protected 중 final이 아닌 모든 메서드
• 재정의 가능한 메서드를 호출할 수 있는 모든 상황을 문서로 남기기
  • 백그라운드 스레드나 정적 초기화 과정에서 호출되는 경우도 생각하기

문서화 예

Implementation Requirements

• API 문서 메서드 설명 끝에서 발견할 수 있는 문구 중 Implementation Requirements가 있음

@implSpec

• 위 에서 소개한 절은 **@implSpec ****태그를 붙이면 자바독 도구가 생성해줌

주석 내용은,