DesignPattern - 커맨드(Command) 패턴

🎮 Unity 디자인 패턴 - 커맨드(Command) 패턴

1. 커맨드 패턴이란?

커맨드(Command) 패턴은 요청(행동)을 하나의 객체로 캡슐화하여,

• 나중에 실행하거나
• 취소하거나
• 저장하거나
• 여러 명령을 큐에 쌓아두었다가 순차적으로 실행할 수 있도록 도와주는 패턴입니다.

"행동을 직접 수행하지 않고, 명령 쪽지를 만들어서 전달하는 방식"이라고 생각하면 이해가 쉽습니다.

---

2. 언제 사용하나요?

• 행동(명령)을 재사용하거나 기록하고 싶을 때
• Undo/Redo, 매크로 명령, 리플레이 기능을 만들고 싶을 때
• UI 버튼이나 키 입력에 대응하는 로직을 유연하게 처리하고 싶을 때

---

3. 구조 구성요소

역할	설명
ICommand	명령의 인터페이스 (Execute, Undo 등)
ConcreteCommand	실제 실행 로직을 담은 명령 객체
Invoker	명령을 실행하는 주체 (예: InputHandler, 버튼 등)
Receiver	명령의 실제 작업을 수행하는 객체

---

4. Unity 예제: 플레이어 명령 시스템

🎮 Step 1: ICommand 인터페이스

public interface ICommand
{
    void Execute();
    void Undo();
}

---

🧱 Step 2: 실제 명령들

public class MoveCommand : ICommand
{
    private Player player;
    public MoveCommand(Player p) => player = p;

    public void Execute() => player.Move();
    public void Undo() => player.Stop();
}

public class JumpCommand : ICommand
{
    private Player player;
    public JumpCommand(Player p) => player = p;

    public void Execute() => player.Jump();
    public void Undo() => Debug.Log("점프 취소");
}

---

🧍 Step 3: 수신자(Receiver) - Player

using UnityEngine;

public class Player : MonoBehaviour
{
    public void Move() => Debug.Log("플레이어 이동 중...");
    public void Jump() => Debug.Log("플레이어 점프!");
    public void Stop() => Debug.Log("플레이어 정지");
}

---

🕹️ Step 4: 입력 핸들러 (Invoker)

using UnityEngine;

public class InputHandler : MonoBehaviour
{
    public Player player;

    private ICommand moveCommand;
    private ICommand jumpCommand;

    private void Start()
    {
        moveCommand = new MoveCommand(player);
        jumpCommand = new JumpCommand(player);
    }

    private void Update()
    {
        if (Input.GetKeyDown(KeyCode.W))
            moveCommand.Execute();

        if (Input.GetKeyDown(KeyCode.Space))
            jumpCommand.Execute();
    }
}

---

5. 확장: 명령 히스토리로 Undo 구현하기

using System.Collections.Generic;

public class CommandManager
{
    private Stack<ICommand> history = new();

    public void ExecuteCommand(ICommand command)
    {
        command.Execute();
        history.Push(command);
    }

    public void UndoCommand()
    {
        if (history.Count > 0)
        {
            ICommand last = history.Pop();
            last.Undo();
        }
    }
}

---

6. 정리 및 장단점

✅ 장점

• 명령을 나중에 실행하거나 취소 가능 (Undo, Replay 등)
• 명령을 모듈화하여 확장성 ↑
• 입력 → 행동을 분리하여 관리하기 쉬움

❌ 단점

• 클래스 수 증가
• 단순한 작업엔 오버헤드 발생

---

✅ 마무리 한 줄 요약

커맨드 패턴은 행동을 객체로 만들고, 실행을 제어하는 구조로, UI, 입력 처리, 실행 기록 기능 등에 매우 적합한 패턴입니다.