Python 디자인 패턴

Python의 State 디자인 패턴

이 레슨에서는 State 패턴으로 객체의 내부 상태가 바뀔 때 동작도 바뀌게 합니다.

  • 고급
  • 3분 분량
  • 실행 가능한 예제 1개

소개

어떤 문제를 해결하나요

미디어 플레이어는 재생 중인지, 일시 정지인지, 정지인지에 따라 다르게 동작합니다. if state == ... 검사로 가득한 큰 메서드를 쓰면, 상태가 하나 늘 때마다 모든 메서드를 손봐야 합니다. 상태(state) 패턴은 상태마다 전용 객체를 하나씩 둡니다.

일상 속 비유

State 패턴은 음악 플레이어의 재생/일시정지 버튼 하나와 비슷합니다. 똑같이 눌러도 플레이어가 지금 무엇을 하고 있는지에 따라 결과가 다릅니다. 재생 중이면 멈추고, 멈춰 있으면 재생합니다. 상태를 바꾸면 버튼이 하는 일이 바뀌고, 플레이어를 새로 만들 필요는 없습니다.

재생/일시정지 버튼에서 코드로
Paused(), Playing()⏯️ 플레이어가 할 수 있는 두 가지 상태
self.state💡 지금 하고 있는 일
player.set_state(Playing())🔁 다른 상태로 바꿉니다
self.state.action()👆 버튼이 현재 상태에게 할 일을 묻습니다
지금의 상태 객체가 플레이어의 동작을 정합니다.
한 문장으로

상태 패턴은 상태마다 별도의 객체를 두고 동작을 그 객체에 맡깁니다. 그래서 객체의 내부 상태가 바뀌면 동작도 따라 바뀝니다.

핵심 포인트

  1. Playing과 Paused에는 둘 다 action() 메서드가 있습니다.
  2. Player는 Paused 상태에서 시작합니다.
  3. set_state는 지금의 상태 객체를 다른 것으로 바꿉니다.
  4. Player.action()은 self.state.action()에 일을 맡기므로, 상태에 따라 결과가 달라집니다.

언제 사용하나요?

  • 모드가 뚜렷이 나뉘는 객체: 미디어 플레이어, 주문, 연결, 게임 캐릭터.
  • 상태 필드를 검사하느라 길어진 if / elif 대체하기.
  • 단계마다 할 수 있는 동작이 다른 작업 흐름.

필요 없는 경우

  • 작은 차이 하나뿐인 단순한 상태 두 개: 불리언 플래그 하나면 충분합니다.
  • 동작이 거의 다 같은 상태들: 클래스를 나누면 코드만 중복됩니다.

예제 코드

코드 실행 →
main.py
class Playing:
    # State: delegate behavior to the current state object.
    def action(self): return "Playing"


class Paused:
    def action(self): return "Paused"


class Player:
    def __init__(self): self.state = Paused()
    def set_state(self, state): self.state = state

    def action(self):
        # Behavior comes from the current state object.
        return self.state.action()


player = Player()
player.set_state(Playing())
print(player.action())
player.set_state(Paused())
print(player.action())
이 예제의 실행 버튼 만들기

실행 결과

Playing
Paused

코드 설명

Player의 action() 메서드는 직접 일하지 않고 현재 상태 객체에 맡깁니다. set_state(Playing()) 다음에는 결과가 Playing입니다. set_state(Paused())로 바꾼 뒤에는 같은 action() 호출이 Paused를 돌려줍니다. 상태를 추가하려면 새 상태 클래스를 만들기만 하면 됩니다.

값을 변경하고 Python 설치 없이 CodeUtility 온라인 Python 컴파일러에서 실행하세요.

연습 문제

아래 제안을 따라 코드를 바꿔 보세요. 코드를 직접 고치고 결과를 확인하면 읽기만 할 때보다 레슨을 훨씬 잘 이해할 수 있습니다.

  1. 패턴 구조를 유지하면서 예제 도메인을 바꿔 보세요.
  2. 패턴을 더 단순한 구현과 비교하고 장단점을 설명하세요.
  3. 다른 구현을 추가하기 전에 각 참여 요소에 대한 테스트를 작성하세요.
Python 컴파일러에서 실행 →

자주 하는 실수

if 문으로 상태 확인하기

상태가 하나 늘 때마다 모든 메서드를 고쳐야 합니다.

문제
def action(self):
    if self.state == "playing":
        return "Playing"
    return "Paused"
수정
def action(self):
    return self.state.action()

이 레슨을 마쳤나요?

학습 완료로 표시하면 진행 상황을 기록할 수 있습니다.

챌린지로 연습하기

이 레슨에서 배운 내용으로 실제 문제를 풀어 보세요. 모든 챌린지는 브라우저에서 실행되며 즉시 테스트와 AI 리뷰를 받을 수 있습니다.

모든 챌린지