가장 우아한 방법
Adapter Pattern(어댑터 패턴), 왜 모든 개발자가 알아야 할까?
실무에서는 이미 운영 중인 레거시 시스템(Legacy System),
외부 API, SDK,
결제 모듈, 클라우드 서비스 등을
새로운 애플리케이션과 연동해야 하는 경우가 매우 많습니다.
하지만 문제는 서로 사용하는 인터페이스(Interface)가
다르다는 것입니다.
이때 기존 코드를 수정하지 않고도 두 시스템을 자연스럽게 연결해 주는
디자인 패턴이 바로 Adapter Pattern(어댑터 패턴) 입니다.
쉽게 말하면
“220V 콘센트에 110V 플러그를 연결하는 변환 어댑터” 와 같은
역할을 합니다.
Adapter Pattern이란?
Adapter Pattern 은 호환되지 않는 인터페이스를 가진 두 객체가 함께 동작할 수 있도록 연결해 주는 구조적(Structural) 디자인 패턴입니다.
기존 클래스를 변경하지 않고 새로운 인터페이스를 제공하므로, 코드 재사용성과 확장성을 크게 높일 수 있습니다.
“기존 코드는 그대로 유지하고, 연결 방식만 바꾸는 것이 Adapter Pattern의 핵심입니다.”
동작 원리
① Client(클라이언트)
서비스를 요청하는 객체입니다.
↓
② Target Interface
클라이언트가 기대하는 표준 인터페이스입니다.
↓
③ Adapter
클라이언트의 요청을 기존 시스템이 이해할 수 있도록 변환합니다.
↓
④ Adaptee
이미 존재하는 기존 클래스 또는 외부 라이브러리입니다.
↓
⑤ Result
변환된 결과를 클라이언트에게 반환합니다.
언제 사용하면 좋을까?
다음과 같은 상황에서 Adapter Pattern은 매우 효과적입니다.
외부 API 또는 SDK 연동
레거시 시스템과 신규 시스템 통합
결제 시스템(PG) 교체
클라우드 서비스 연동
서로 다른 라이브러리 통합
오래된 코드 재사용
인터페이스가 변경된 시스템 연결
사용을 피해야 하는 경우
다음과 같은 상황에서는 Adapter Pattern이 불필요할 수 있습니다.
이미 인터페이스가 동일한 경우
단순히 메서드 이름만 변경하면 되는 경우
Adapter가 지나치게 많아져 구조가 복잡해지는 경우
새로운 시스템을 처음부터 설계하는 경우
실무 활용 사례
결제 시스템
기존
PaymentService
↓
새로운 PG사
Toss Payments
↓
Adapter
PaymentAdapter
기존 코드를 수정하지 않고 새로운 결제 시스템을 연결할 수 있습니다.
Cloud API
AWS SDK
↓
Adapter
↓
Azure SDK
↓
Google Cloud SDK
하나의 인터페이스만 유지하면 여러 클라우드 서비스를 쉽게 교체할 수 있습니다.
파일 저장소
Local Storage
↓
Adapter
↓
Amazon S3
↓
Google Cloud Storage
↓
Azure Blob Storage
저장소가 바뀌어도 애플리케이션 코드는 그대로 유지됩니다.
AI API
OpenAI API
↓
Adapter
↓
Claude API
↓
Gemini API
↓
Mistral API
↓
DeepSeek API
↓
Qwen API
AI 모델을 교체해도 비즈니스 로직은 변경할 필요가 없습니다.
Adapter Pattern의 장점
기존 코드 수정 최소화
코드 재사용성 향상
시스템 간 결합도 감소(Loose Coupling)
유지보수 용이
외부 라이브러리 교체가 쉬움
확장성 향상
SOLID 원칙(Open-Closed Principle) 준수
단점
클래스 수가 증가할 수 있음
Adapter가 너무 많아지면 구조가 복잡해질 수 있음
단순한 프로젝트에서는 오히려 과도한 설계가 될 수 있음
Java에서 대표적인 Adapter 사례
Java 표준 라이브러리에서도 Adapter Pattern은 매우 자주 사용됩니다.
* InputStreamReader : 바이트 스트림을 문자 스트림으로 변환
* OutputStreamWriter : 문자 스트림을 바이트 스트림으로 변환
* Collections.list() : Enumeration을 List 형태로 변환
* Spring MVC HandlerAdapter : 다양한 Controller를 동일한 방식으로 실행
* JDBC Driver : 데이터베이스별 드라이버를 공통 인터페이스로 사용
핵심 메시지
Adapter Pattern은 단순한 디자인 패턴이 아니라 기존 시스템과 새로운 시스템을 안전하게 연결하는 실무 핵심 기술입니다.
특히 레거시 시스템 현대화, 마이크로서비스, 클라우드 전환, API 통합, AI 서비스 연동과 같은 현대 소프트웨어 아키텍처에서는 거의 필수적으로 활용됩니다.
좋은 개발자는 코드를 많이 수정하는 사람이 아니라, 기존 자산을 최대한 활용하면서 새로운 기술을 유연하게 연결하는 사람입니다.
“변경은 최소화하고, 확장은 자유롭게.”
이것이 Adapter Pattern이 오랫동안 사랑받는 이유입니다.
도움이 되셨다면 ‘좋아요’와 ‘공유’를 부탁드립니다!
디자인 패턴(GoF), Java,
Spring Boot, Python,
PHP, AI 아키텍처,
DevOps 실무 시리즈도 계속 소개해 드리겠습니다.
— 이춘곤(Mark) · ISC.studio · ISC출판 도서 안내
이 글은 저자의 Facebook에 처음 게시한 글입니다. Facebook 원문 보기
💬 댓글 (0)