어댑터 패턴 (Adapter Pattern)

어댑터 패턴(Adapter Pattern)은 서로 호환되지 않는 인터페이스를 가진 클래스를 클라이언트가 기대하는 인터페이스로 변환해 함께 동작하게 만드는 구조 디자인 패턴이다. 어댑터 패턴을 적용하면 기존 클래스나 외부 라이브러리의 코드를 한 줄도 수정하지 않고 새로운 시스템에 연결할 수 있다. 해외여행에서 콘센트 규격이 다를 때 변환 플러그를 끼워 쓰는 상황에 자주 비유된다.

패턴의 의도

소프트웨어를 개발하다 보면 이미 검증된 클래스를 재사용하고 싶은데 그 클래스의 메서드 시그니처가 현재 시스템이 요구하는 인터페이스와 맞지 않는 상황을 자주 만난다. 외부 라이브러리는 소스 코드를 고칠 수 없고, 레거시 코드는 수정했다가 기존 기능이 깨질 위험이 크다. 이때 두 인터페이스 사이에 변환 계층을 하나 두면 양쪽 모두 손대지 않고 연결할 수 있다.

어댑터 패턴의 핵심 의도는 "인터페이스 불일치 때문에 함께 쓸 수 없던 클래스들을 협력하게 만든다"는 것이다. 어댑터는 클라이언트가 기대하는 인터페이스를 구현하고, 내부에서는 기존 객체의 메서드를 호출하면서 필요한 형 변환이나 파라미터 매핑을 수행한다. 즉 어댑터는 새로운 기능을 추가하는 존재가 아니라 이미 있는 기능의 호출 방식을 바꿔 주는 번역자 역할을 한다.

구조와 참여 객체

어댑터 패턴에는 네 종류의 참여자가 등장한다. 각 참여자의 역할을 정확히 구분해서 설명할 수 있어야 면접에서도 흔들리지 않는다.

• 타깃(Target): 클라이언트가 사용하려는 인터페이스다. 시스템이 요구하는 표준 규격에 해당한다.
• 어댑티(Adaptee): 재사용하고 싶지만 인터페이스가 맞지 않는 기존 클래스다. 레거시 코드나 외부 라이브러리가 여기에 해당한다.
• 어댑터(Adapter): 타깃 인터페이스를 구현하면서 내부에서 어댑티를 호출하는 변환 계층이다. 두 세계를 잇는 다리 역할을 한다.
• 클라이언트(Client): 타깃 인터페이스에만 의존해서 동작하는 코드다. 어댑티의 존재를 전혀 모른다.

호출 흐름은 단순하다. 클라이언트가 타깃 인터페이스의 메서드를 호출하면 어댑터가 그 요청을 받아 어댑티가 이해할 수 있는 형태로 바꿔 전달하고, 어댑티의 결과를 다시 타깃이 약속한 형태로 돌려준다. 클라이언트 입장에서는 어댑터도 그저 타깃의 구현체 중 하나일 뿐이다.

Java 코드 예시

새 결제 시스템은 원화 금액을 정수로 받는 인터페이스를 요구하는데, 사내 레거시 과금 모듈은 문자열 형태의 금액만 받는 상황을 가정한다.

// 타깃: 새 시스템이 요구하는 인터페이스
public interface PaymentProcessor {
    void pay(int amountWon);
}

// 어댑티: 수정할 수 없는 레거시 과금 모듈
public class LegacyBillingSystem {
    public void charge(String formattedAmount) {
        System.out.println(formattedAmount + " 청구 완료");
    }
}

// 어댑터: 타깃을 구현하고 내부에서 어댑티를 호출
public class BillingAdapter implements PaymentProcessor {
    private final LegacyBillingSystem legacy;

    public BillingAdapter(LegacyBillingSystem legacy) {
        this.legacy = legacy;
    }

    @Override
    public void pay(int amountWon) {
        // 정수 금액을 레거시가 요구하는 문자열 형식으로 변환
        legacy.charge(amountWon + "원");
    }
}

// 클라이언트: 타깃 인터페이스에만 의존
PaymentProcessor processor = new BillingAdapter(new LegacyBillingSystem());
processor.pay(15000);

클라이언트 코드는 PaymentProcessor만 알고 있으므로, 나중에 레거시 모듈을 완전히 걷어내고 새 구현체로 교체해도 클라이언트는 전혀 바뀌지 않는다. 어댑터가 변경의 파급 범위를 한 클래스 안으로 가둔 것이다.