Python의 Builder 디자인 패턴
이 레슨에서는 Builder 패턴으로 복잡한 객체를 명확한 여러 단계에 걸쳐 만듭니다.
소개
어떤 문제를 해결하나요
어떤 객체에는 선택적인 부분이 많습니다. 보고서에는 제목, 차트, 표, 바닥글이 있거나 그 조합이 있을 수 있습니다. 선택적 인수가 열 개인 생성자는 읽기 어렵고 잘못 호출하기 쉽습니다. 빌더는 부분을 한 단계씩 분명하게 더합니다.
일상 속 비유
빌더(builder)는 카운터에서 샌드위치를 주문하는 것과 같습니다. "빵, 그다음 치즈, 그다음 토마토" 라고 말하면 지시할 때마다 샌드위치가 커집니다. "됐어요" 라고 하면 완성된 샌드위치를 받습니다.
ReportBuilder()🍞 빈 주문 시작.add_title()🧀 재료 하나 더하기.add_chart()🍅 하나 더, 순서가 중요.build()🥪 완성된 샌드위치 건네기빌더 패턴은 별도의 메서드로 복잡한 객체를 한 단계씩 만들고, 마지막 build 호출에서 완성된 객체를 돌려줍니다.
핵심 포인트
self.parts는 지금까지 더한 부분을 모읍니다.add_title과add_chart는 각각 부분 하나를 더하고return self하므로 호출을 이을 수 있습니다.ReportBuilder().add_title().add_chart().build()는 지시 목록처럼 읽힙니다.build()는 모은 부분을 완성된 보고서 텍스트로 바꿉니다.
언제 사용하나요?
- 선택적 부분이 많은 객체: 보고서, HTTP 요청, SQL 쿼리, 문서.
- 메서드 체이닝으로 단계별 생성을 읽기 쉽게 하기.
- 같은 생성 단계로 다른 변형 만들기.
필요 없는 경우
- 필수 필드가 두세 개인 객체: 평범한 생성자나 데이터클래스가 더 간단합니다.
- 기본값이 있는 키워드 인수로 이미 호출이 분명한 Python 코드.
예제 코드
class ReportBuilder:
# Builder: assemble a complex value one optional part at a time.
def __init__(self):
self.parts = []
def add_title(self):
self.parts.append("title")
return self
def add_chart(self):
self.parts.append("chart")
return self
def build(self):
# Hide the final assembly behind one operation.
return "Report: " + ", ".join(self.parts)
report = ReportBuilder().add_title().add_chart().build()
print(report)
실행 결과
Report: title, chart
코드 설명
add_title() 같은 각 메서드는 보고서에 부분을 하나 추가한 뒤 builder 객체 자신을 돌려줍니다(return self). 그래서 호출을 한 줄로 이어서 쓸 수 있습니다. 마지막으로 build() 메서드가 부분들을 모아 완성된 보고서 Report: title, chart를 돌려줍니다.
값을 변경하고 Python 설치 없이 CodeUtility 온라인 Python 컴파일러에서 실행하세요.
연습 문제
아래 제안을 따라 코드를 바꿔 보세요. 코드를 직접 고치고 결과를 확인하면 읽기만 할 때보다 레슨을 훨씬 잘 이해할 수 있습니다.
- 패턴 구조를 유지하면서 예제 도메인을 바꿔 보세요.
- 패턴을 더 단순한 구현과 비교하고 장단점을 설명하세요.
- 다른 구현을 추가하기 전에 각 참여 요소에 대한 테스트를 작성하세요.
자주 하는 실수
return self 를 잊기
return self 가 없으면 메서드가 None 을 돌려줘 체이닝이 실패합니다.
def add_title(self):
self.parts.append("title")
def add_title(self):
self.parts.append("title")
return self
이 레슨을 마쳤나요?
학습 완료로 표시하면 진행 상황을 기록할 수 있습니다.
챌린지로 연습하기
이 레슨에서 배운 내용으로 실제 문제를 풀어 보세요. 모든 챌린지는 브라우저에서 실행되며 즉시 테스트와 AI 리뷰를 받을 수 있습니다.
모든 챌린지