Patron Commande

Le modèle Command transforme une action en objet. L’objet stocke tout ce dont vous avez besoin pour exécuter l’action, afin que vous puissiez le conserver dans une liste, l’exécuter plus tard ou l’annuler.

Chaque commande possède les deux mêmes méthodes, déclarées par une classe parente abstraite :

# command.gd
@abstract
class_name Command
extends RefCounted

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

Une commande concrète conserve l’objet sur lequel elle agit, appelé le récepteur, ainsi que les données de l’action. Ici, le récepteur est un Hero avec un 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

L’invocateur exécute les commandes et s’en souvient. Il n’a jamais besoin de savoir ce que fait une commande :

# 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

L’historique est une pile : pop_back() récupère la commande la plus récente, donc l’annulation remonte les actions dans l’ordre inverse. Les mêmes objets permettent de réassocier les touches (une touche correspond à une commande), de rejouer les actions (exécuter à nouveau la liste enregistrée) et de gérer des files de tours.

Les références vont dans un seul sens : les commandes pointent vers le héros, et le héros ne sait rien à leur sujet. Si le héros stockait également ses commandes, les objets se maintiendraient mutuellement en vie et ne seraient jamais libérés.