코틀린 디자인 패턴 (14) - Command 패턴으로 실행과 취소를 다루는 법

이 글의 목차 숨기기

왜 이 패턴이 필요할까

가장 짧은 정의: 요청을 객체로 만든다

마무리

코틀린 Command 패턴은 단순히 메서드 호출을 한 번 감싸는 기술이 아닙니다. 실행 요청을 객체로 만들면, 그 요청을 나중에 실행하거나 취소하고, 큐에 담고, 기록으로 남기는 구조가 가능해집니다. 그래서 Command 패턴은 특히 실행과 취소를 함께 다뤄야 하는 문제에서 의미가 커집니다.

이번 글에서는 Command 패턴을 “버튼 하나 누르면 함수 실행” 수준이 아니라, 왜 undo/redo, 실행 기록, 큐잉 구조에 잘 맞는지까지 코틀린 예제로 자세히 설명하겠습니다.

Command 패턴 핵심 요약 카드 — 요청을 객체로 만들면 실행, 취소, 재실행, 기록을 같은 단위로 다루기 쉬워진다

왜 이 패턴이 필요할까

처음에는 단순 함수 호출만으로도 충분해 보입니다. 하지만 기능이 늘어나면 요청을 즉시 실행하는 것만으로는 부족해집니다. 예를 들어 실행 취소가 필요하고, 나중에 다시 실행해야 하고, 사용자의 행동을 히스토리로 보관해야 할 수도 있습니다.

이때 메서드 호출만 흩어져 있으면 누가 무엇을 실행했고 어떻게 취소할지를 추적하기 어려워집니다. Command 패턴은 이 실행 단위를 하나의 객체로 묶어서 구조를 정리합니다.

가장 짧은 정의: 요청을 객체로 만든다

Command 패턴의 핵심은 요청 자체를 독립 객체로 만드는 것입니다. 그 객체 안에는 실행에 필요한 receiver와 파라미터, 그리고 경우에 따라 undo를 위한 정보까지 담길 수 있습니다.

즉 단순히 “무엇을 할까”를 함수 이름으로만 표현하지 않고, 실행 가능한 작업 단위로 다루게 되는 셈입니다.

Command 실행과 취소 흐름 그림 — Command는 실행 단위를 객체로 만들기 때문에 기록, 취소, 재실행 흐름과 잘 맞는다

코틀린 코드로 보면 어떻게 생길까

interface Command {
    fun execute()
    fun undo()
}

class TextEditor {
    private val buffer = StringBuilder()

    fun append(text: String) {
        buffer.append(text)
    }

    fun deleteLast(length: Int) {
        buffer.delete(buffer.length - length, buffer.length)
    }

    fun content(): String = buffer.toString()
}

class AppendTextCommand(
    private val editor: TextEditor,
    private val text: String,
) : Command {
    override fun execute() {
        editor.append(text)
    }

    override fun undo() {
        editor.deleteLast(text.length)
    }
}

interface Command {
    fun execute()
    fun undo()
}

class TextEditor {
    private val buffer = StringBuilder()

    fun append(text: String) {
        buffer.append(text)
    }

    fun deleteLast(length: Int) {
        buffer.delete(buffer.length - length, buffer.length)
    }

    fun content(): String = buffer.toString()
}

class AppendTextCommand(
    private val editor: TextEditor,
    private val text: String,
) : Command {
    override fun execute() {
        editor.append(text)
    }

    override fun undo() {
        editor.deleteLast(text.length)
    }
}