템플릿 메서드 패턴 Java 구현 (Template Method in Java)

Java에서 템플릿 메서드 패턴(Template Method Pattern)을 구현할 때는 추상 클래스의 접근 제어자 설계, final 선언, 훅 메서드(Hook Method) 배치가 품질을 좌우한다. 이 문서는 템플릿 메서드를 Java 코드로 견고하게 설계하는 방법과 JDK, 프레임워크 속 실제 사례를 살펴보고, 상속 대신 람다 콜백으로 같은 목적을 달성하는 현대적 변형과 비교한다.

추상 클래스 설계의 원칙

Java로 템플릿 메서드를 구현할 때 지켜야 할 설계 규칙은 다음과 같다. 첫째, 템플릿 메서드 자체는 public final로 선언한다. final이 없으면 하위 클래스가 골격 전체를 오버라이드해 절차 보장이 무너질 수 있다. 둘째, 하위 클래스가 구현할 단계 메서드는 protected abstract로 선언한다. protected로 두는 이유는 이 메서드들이 외부 클라이언트가 직접 호출할 API가 아니라 상위 클래스만 호출하는 내부 확장 지점이기 때문이다. 셋째, 하위 클래스가 몰라도 되는 공통 단계는 private으로 숨겨 오버라이드 자체를 차단한다.

public abstract class ReportGenerator {

    // 골격: public final, 외부에 공개되는 유일한 진입점
    public final String generate() {
        StringBuilder sb = new StringBuilder();
        sb.append(header());          // private 공통 단계
        sb.append(body());            // protected abstract 가변 단계
        if (includeFooter()) {        // 훅 메서드
            sb.append(footer());
        }
        return sb.toString();
    }

    private String header() { return "== 리포트 ==\n"; }
    private String footer() { return "\n== 끝 =="; }

    protected abstract String body();

    // 훅: 합리적 기본값 제공, 선택적 오버라이드
    protected boolean includeFooter() { return true; }
}

public class SalesReport extends ReportGenerator {
    @Override
    protected String body() {
        return "이번 달 매출 집계";
    }

    @Override
    protected boolean includeFooter() {
        return false;  // 이 리포트만 푸터 생략
    }
}

추상 메서드 수는 최소로 유지하는 것이 좋다. 필수 구현 지점이 많을수록 하위 클래스 작성 부담이 커지므로, "반드시 달라야 하는 것"만 abstract로 두고 "달라질 수도 있는 것"은 훅으로 내리는 것이 요령이다.

훅 메서드의 역할과 활용

훅 메서드는 기본 구현을 가진 protected 메서드로, 하위 클래스에 선택적 개입 지점을 열어 준다. 활용 형태는 세 가지다. 첫째, 위 예시의 includeFooter처럼 boolean을 반환해 알고리즘의 조건 분기를 하위 클래스가 제어하게 하는 형태다. 둘째, 특정 단계 전후에 빈 구현으로 끼워 둔 beforeBody, afterBody 같은 확장 지점 형태로, 하위 클래스는 필요할 때만 오버라이드해 로깅이나 자원 준비를 추가한다. 셋째, 기본 동작을 제공하되 교체를 허용하는 형태다. 추상 메서드가 "구현 강제"라면 훅은 "개입 허용"이라는 점이 본질적 차이이며, 이 구분을 문서 주석으로 명시해 주는 것이 협업에 도움이 된다.

JDK와 프레임워크 속 사례

템플릿 메서드는 Java 생태계 어디에나 있다. 컬렉션 프레임워크의 AbstractList는 get과 size만 구현하면 indexOf, contains, iterator 같은 나머지 동작이 골격 코드로 완성되는 골격 구현(skeletal implementation) 클래스다. 서블릿의 HttpServlet은 service 메서드가 HTTP 메서드를 판별해 doGet, doPost로 분기하는 구조로, 개발자는 필요한 do 메서드만 오버라이드한다. 입출력의 InputStream도 추상 메서드 read() 하나를 기반으로 다중 바이트 읽기 메서드들이 구현되어 있다. Spring에서는 JdbcTemplate처럼 이름에 템플릿이 붙은 클래스들이 자원 획득, 예외 변환, 자원 해제라는 골격을 제공하는데, 이들은 상속이 아니라 콜백 객체를 받는 변형이라는 점이 흥미로운 관찰 지점이다.

public class ReportTemplate {

    // 가변 단계를 파라미터로 주입받는다
    public String generate(Supplier<String> bodySupplier) {
        return "== 리포트 ==\n"
                + bodySupplier.get()
                + "\n== 끝 ==";
    }
}

// 사용: 하위 클래스 없이 람다로 단계 주입
ReportTemplate template = new ReportTemplate();
String report = template.generate(() -> "이번 달 매출 집계");