# 자바 디자인 패턴 입문 - Adapter 패턴 쉽게 이해하기

Adapter 패턴이란?

인터페이스가 맞지 않는 두 객체 사이를 중간에서 “변환”해주는 패턴
“변환 어댑터” 역할을 하는 클래스

쉽게 말하면,
내가 원하는 방식으로 기존 코드를 “감싸서” 쓰게 해주는 구조다.

 

왜 Adapter 패턴이 필요할까?

1.기존 클래스가 너무 복잡하거나 불편할 때

→ ex. Properties, InputStream, Thread 등

 

2.내가 원하는 메서드 이름이나 구조와 안맞을 때

→ 메서드 이름 바꾸거나, 기능을 조합해서 새 인터페이스로 제공하고 싶을 때

 

구조 이해 (클래스 명은 예시)

역할	이름	설명
Target (타겟 인터페이스)	Print	클라이언트가 기대하는 인터페이스
Adaptee (기존 클래스)	Banner	인터페이스가 맞지 않는 기존 클래스
Adapter	PrintBanner	Print 인터페이스를 구현하면서 Banner 사용

 

코드 예제

Target 인터페이스

public interface Print {
    void printWeak();
    void printStrong();
}

 

Adaptee 클래스

public class Banner {
    private String string;

    public Banner(String string) {
        this.string = string;
    }

    public void showWithParen() {
        System.out.println("(" + string + ")");
    }

    public void showWithAster() {
        System.out.println("*" + string + "*");
    }
}

 

Adapter 클래스

public class PrintBanner implements Print {
    private Banner banner;

    public PrintBanner(String string) {
        this.banner = new Banner(string);
    }

    public void printWeak() {
        banner.showWithParen(); // (Hello)
    }

    public void printStrong() {
        banner.showWithAster(); // *Hello*
    }
}

 

사용 코드

public class Main {
    public static void main(String[] args) {
        Print p = new PrintBanner("Hello");
        p.printWeak();    // (Hello)
        p.printStrong();  // *Hello*
    }
}

Banner는 원래 showWith...() 메서드를 제공하는데

printWeak(), printStrong()이라는 다른 이름으로 쓰고 싶음. 그래서 중간에 PrintBanner가 번역해주는 역할

 

실무에서 Adapter는 언제 쓰이나?

• 기존 클래스가 있는데, 내가 쓰려는 코드랑 인터페이스가 안 맞을 때
• 라이브러리/레거시 코드 감쌀 때 (예: 외부 API → 내가 원하는 구조로 바꾸기)
• 스프링에서도 많이 씀 → HandlerAdapter, WebMvcConfigurerAdapter

 

❗ 근데 요즘에는 클래스 이름에 Adapter가 붙는 경우는 많이 줄음.

Java 8에서 default method 기능이 생김

→ 인터페이스만 구현해도 메서드 다 구현 안 해도 됨
→ WebMvcConfigurerAdapter 같은 이름이 사라짐

 

Spring은 확장성, 유연성 중시 → 전략 패턴이나 템플릿 메서드 패턴으로 많이 해결

 

클래스 이름	역할	왜 Adapter인지
HandlerAdapter	다양한 Controller 방식 처리 (ex. @Controller, HttpRequestHandler, Controller)	컨트롤러가 다 다른 방식이니까 → 중간에서 맞춰줌
MessageConverter	HTTP 바디 <-> 자바 객체 변환 (JSON, XML 등)	JSON 파서와 자바 객체 간 형식 어댑터 역할
WebMvcConfigurer	Web 설정을 내 방식으로 바꿔 끼우게 해줌	설정 인터페이스 ↔ 내 설정 클래스 연결
ResourceHttpRequestHandler	정적 자원 처리기	요청 ↔ 파일 시스템을 연결해주는 어댑터

 

자바 기본 클래스에서 어댑터로 감싸기 좋은 것들

클래스	why?
Properties	key-value 읽고 쓰기 불편함
InputStream	바이트 기반, 문자 기반으로 감싸야 편함
Thread	상속 방식 불편 → Runnable로 바꾸는 게 좋음
Map	반복문/정렬 등 확장하기 애매함
Socket	통신 방식 추상화할 때 유용

 

마무리 정리

Adapter 패턴은 단순한 디자인 개념이 아니라 기존 코드를 “내 코드답게” 바꿔주는 무기다.

 

자바에서 기본 클래스를 많이 알수록,
Adapter를 통해 훨씬 더 유연하고 유지보수 좋은 코드를 짤 수 있다.