Befehl-Muster

Das Command-Muster verwandelt eine Aktion in ein Objekt. Das Objekt speichert alles, was zum Ausführen der Aktion benötigt wird, sodass du sie in einer Liste speichern, später ausführen oder rückgängig machen kannst.

Jeder Befehl hat dieselben zwei Methoden, die von einer abstrakten übergeordneten Klasse deklariert werden:

# command.gd
@abstract
class_name Command
extends RefCounted

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

Ein konkreter Befehl speichert das Objekt, auf das er angewendet wird, den sogenannten Empfänger, sowie die Daten der Aktion. Hier ist der Empfänger ein Hero mit einem 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

Der Aufrufer führt Befehle aus und merkt sie sich. Er muss nie wissen, was ein Befehl bewirkt:

# 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

Der Verlauf ist ein Stapel: pop_back() nimmt den neuesten Befehl, sodass beim Rückgängigmachen die Aktionen in umgekehrter Reihenfolge durchlaufen werden. Dieselben Objekte ermöglichen dir auch eine Neubelegung der Tasten (eine Taste wird einem Befehl zugeordnet), Wiederholungen (die gespeicherte Liste wird erneut ausgeführt) und Zugwarteschlangen.

Referenzen verlaufen nur in eine Richtung: Die Befehle verweisen auf den Helden, und der Held weiß nichts von ihnen. Wenn der Held seine Befehle ebenfalls speichern würde, würden die Objekte sich gegenseitig am Leben erhalten und niemals freigegeben werden.