Padrão Command

O padrão Command transforma uma ação em um objeto. O objeto armazena tudo o que é necessário para executar a ação, para que você possa mantê-lo em uma lista, executá-lo mais tarde ou desfazê-lo.

Todo comando tem os mesmos dois métodos, declarados por uma classe pai abstrata:

# command.gd
@abstract
class_name Command
extends RefCounted

@abstract func execute() -> void
@abstract func undo() -> void

Um comando concreto mantém o objeto sobre o qual atua, chamado receptor, e os dados da ação. Aqui, o receptor é um Hero com um var x := 0:

# move_command.gd
class_name MoveCommand
extends Command

var hero: Hero
var dx: int

func _init(target: Hero, step: int) -> void:
	hero = target
	dx = step

func execute() -> void:
	hero.x += dx

func undo() -> void:
	hero.x -= dx

O invocador executa comandos e se lembra deles. Ele não precisa saber o que um comando faz:

# command_history.gd
class_name CommandHistory
extends RefCounted

var done: Array[Command] = []

func run(command: Command) -> void:
	command.execute()
	done.append(command)

func undo_last() -> void:
	if done.is_empty():
		return
	var last: Command = done.pop_back()
	last.undo()

# main.gd
var hero := Hero.new()
var history := CommandHistory.new()
history.run(MoveCommand.new(hero, 3))
history.run(MoveCommand.new(hero, 2))
print(hero.x)
history.undo_last()
print(hero.x)

5
3

O histórico é uma pilha: pop_back() pega o comando mais recente, então desfazer percorre as ações na ordem inversa. Os mesmos objetos permitem remapear teclas (uma tecla corresponde a um comando), reproduzir ações (executar novamente a lista salva) e criar filas de turnos.

As referências vão em uma só direção: os comandos apontam para o herói, e o herói não sabe nada sobre eles. Se o herói também armazenasse seus comandos, os objetos manteriam uns aos outros vivos e nunca seriam liberados.