Durum Kalıbı

State kalıbı, bir nesneye içinde bulunabileceği her mod için ayrı bir durum nesnesi verir. Nesne, işini mevcut duruma devreder; böylece durum değiştiğinde davranışı da değişir.

Birkaç durum için bir enum ve match yeterlidir. Her durum birkaç eyleme kendine özgü şekilde tepki verdiğinde, bu match her durum ve her eylemle büyür. State kalıbı, her durumun kurallarını kendi sınıfına taşır:

# hero_state.gd
@abstract
class_name HeroState
extends RefCounted

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

handle() bir sonraki durumu döndürür: geçiş yapılacak yeni bir durum nesnesi veya kalmak için self.

# 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 de aynı şekilde yazılır: adı "Running" olur ve "stop", IdleState.new() döndürür. Kahraman, yani bağlam, geçerli durumu saklar ve ne yapacağını ona sorar:

# 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

Aynı eylem farklı durumlarda farklı anlamlara gelir: "stop", boşta beklerken hiçbir şey yapmaz ve çalışan bir kahramanı durdurur. Her kural kendi durumunun sınıfında yer alır; bu nedenle zıplama gibi yeni bir durum, yeni bir sınıf demektir.

Durumlar, kahramanı saklamak yerine bir sonraki durumu döndürür. Kahramanı saklayan bir durum ile durumu saklayan kahraman arasında bir başvuru döngüsü oluşur ve iki nesne de hiçbir zaman bellekten silinmez.