Wzorzec polecenia

Wzorzec Command zamienia działanie w obiekt. Obiekt przechowuje wszystko, co jest potrzebne do wykonania działania, więc możesz umieścić go na liście, wykonać później lub cofnąć.

Każde polecenie ma te same dwie metody, zadeklarowane w abstrakcyjnej klasie bazowej:

# command.gd
@abstract
class_name Command
extends RefCounted

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

Konkretny rozkaz przechowuje obiekt, na którym działa, nazywany odbiorcą, oraz dane akcji. Tutaj odbiorcą jest Hero z 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

Element wywołujący uruchamia polecenia i zapamiętuje je. Nie musi wiedzieć, co robi polecenie:

# 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

Historia jest stosem: pop_back() pobiera najnowsze polecenie, więc cofanie przechodzi przez działania w odwrotnej kolejności. Te same obiekty umożliwiają ponowne przypisywanie klawiszy (klawisz jest przypisany do polecenia), odtwarzanie (ponowne uruchomienie zapisanej listy) i kolejki tur.

Referencje działają w jedną stronę: polecenia wskazują na bohatera, a bohater nic o nich nie wie. Gdyby bohater przechowywał również swoje polecenia, obiekty podtrzymywałyby się nawzajem przy życiu i nigdy nie zostałyby zwolnione.