두 가지 이상의 의미를 표현할 수 있으며, 그중 현재 표현하는 의미를 태그 값으로 알려주는 클래스가 있다. // 코드 23-1 태그 달린 클래스 - 클래스 계층구조보다 훨씬 나쁘다! (142-143쪽) class Figure { enum Shape { RECTANGLE, CIRCLE } // 태그 필드 - 현재 모양을 나타낸다. final Shape shape; // 다음 필드들은 모양이 사각형(RECTANGLE)일 때만 쓰인다. double length; double width; // 다음 필드는 모양이 원(CIRCLE)일 때만 쓰인다. double radius; // 원용 생성자 Figure(double radius) { shape = Shape.CIRCLE; this.radius = radius; ..

item18에서는 상속을 염두에 두지 않고 설계했고 상속할 때의 주의점도 문서화해놓지 않은 외부 클래스를 상속할 때의 위험을 경고했다. 그렇다면 상속을 고려한 설계와 문서화란 정확히 무엇일까? 상속용 클래스는 재정의할 수 있는 메서드들의 내부 구현을 문서로 남겨야 한다. 클래스의 API로 공개된 메서드에서 자신의또 다른 메서들르 호출할 수도 있다. 그런데 마침 호출되는 메서드가 재정의 가능 메서드라면 그 사실을 호출하는 메서드의 API 설명에 적시해야 한다. 즉 재정의 가능 메서드를 호출할 수 있는 모든 상황을 문서로 남겨야 한다. @implSpec 태그를 붙여주면 자바독 도구가 내부 동작 방식을 설명하는 곳을 생성해준다. 예제1) public class ExtendableClass { /** * Thi..