Patron État

Le patron État attribue à un objet un objet d’état distinct pour chaque mode dans lequel il peut se trouver. L’objet délègue son travail à l’état actuel, de sorte que son comportement change lorsque l’état change.

Pour quelques états, une énumération et un match suffisent. Lorsque chaque état réagit à plusieurs actions à sa manière, ce match s’allonge à chaque état et à chaque action. Le patron État déplace les règles de chaque état dans sa propre classe :

# hero_state.gd
@abstract
class_name HeroState
extends RefCounted

@abstract func get_state_name() -> String
@abstract func handle(action: String) -> HeroState

handle() renvoie l’état suivant : un nouvel objet d’état vers lequel passer, ou self pour rester dans l’état actuel.

# idle_state.gd
class_name IdleState
extends HeroState

func get_state_name() -> String:
	return "Idle"

func handle(action: String) -> HeroState:
	if action == "run":
		return RunState.new()
	return self

RunState s’écrit de la même manière : son nom est "Running", et "stop" renvoie IdleState.new(). Le héros, le contexte, conserve l’état actuel et lui demande quoi faire :

# hero.gd
class_name Hero
extends RefCounted

var state: HeroState = IdleState.new()

func handle_action(action: String) -> void:
	var next := state.handle(action)
	if next != state:
		print(state.get_state_name(), " -> ", next.get_state_name())
		state = next

# main.gd
var hero := Hero.new()
for action in ["stop", "run", "run", "stop"]:
	hero.handle_action(action)

Idle -> Running
Running -> Idle

La même action signifie des choses différentes selon l’état : "stop" ne fait rien à l’arrêt et arrête un héros en mouvement. Chaque règle se trouve dans la classe de son état, donc un nouvel état, comme le saut, correspond à une nouvelle classe.

Les états renvoient l’état suivant au lieu de stocker le héros. Un état qui conserverait le héros tandis que le héros conserverait l’état créerait un cycle de références, et aucun des deux objets ne serait jamais libéré.