Wzorzec stanu

Wzorzec State przypisuje obiektowi osobny obiekt stanu dla każdego trybu, w którym może się on znajdować. Obiekt przekazuje wykonywaną pracę aktualnemu stanowi, więc jego zachowanie zmienia się wraz ze zmianą stanu.

W przypadku kilku stanów wystarczą enum i instrukcja match. Gdy każdy stan reaguje na kilka działań na swój sposób, instrukcja match rozrasta się wraz z każdym stanem i każdym działaniem. Wzorzec State przenosi reguły każdego stanu do jego własnej klasy:

# hero_state.gd
@abstract
class_name HeroState
extends RefCounted

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

handle() zwraca następny stan: nowy obiekt stanu, na który należy przejść, albo self, aby pozostać w bieżącym stanie.

# 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 jest zapisany w ten sam sposób: jego nazwa to "Running", a "stop" zwraca IdleState.new(). Bohater, czyli kontekst, przechowuje bieżący stan i pyta go, co ma zrobić:

# 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

To samo działanie oznacza różne rzeczy w różnych stanach: "stop" nic nie robi, gdy bohater jest bezczynny, a zatrzymuje go, gdy biegnie. Każda reguła znajduje się w klasie danego stanu, więc nowy stan, taki jak skakanie, oznacza jedną nową klasę.

Stany zwracają następny stan zamiast przechowywać bohatera. Stan, który przechowywałby bohatera, gdyby bohater przechowywał stan, tworzyłby cykl referencji, a żaden z tych obiektów nigdy nie zostałby zwolniony.