Adapter-Muster

Das Adapter-Muster ermöglicht es einem Objekt, mit Code zusammenzuarbeiten, der andere Methoden erwartet. Der Adapter umschließt das Objekt und wandelt jeden erwarteten Aufruf in einen Aufruf um, den das Objekt versteht.

Eine alte Klasse aus einem früheren Projekt speichert die Gesundheit als zwei Zahlen:

# old_monster.gd
class_name OldMonster
extends RefCounted

var life := 30
var max_life := 120

Dein HUD zeigt alles an, was get_label() und get_hp_percent() hat. Ein Knight hat bereits beides (es gibt "Knight" und 80 zurück), aber OldMonster hat keines von beiden:

# health_display.gd
class_name HealthDisplay
extends RefCounted

func show_health(target) -> void:
	print(target.get_label(), ": ", target.get_hp_percent(), "%")

Der Adapter enthält ein OldMonster und stellt die beiden Methoden bereit, die die Anzeige aufruft:

# monster_adapter.gd
class_name MonsterAdapter
extends RefCounted

var monster: OldMonster

func _init(wrapped: OldMonster) -> void:
	monster = wrapped

func get_label() -> String:
	return "Monster"

func get_hp_percent() -> int:
	return monster.life * 100 / monster.max_life

# main.gd
var display := HealthDisplay.new()
display.show_health(Knight.new())
display.show_health(MonsterAdapter.new(OldMonster.new()))

Knight: 80%
Monster: 25%

Weder OldMonster noch HealthDisplay haben sich geändert. Das ist wichtig, wenn du eine Klasse nicht bearbeiten kannst oder solltest: Sie stammt aus einem Plugin, ein anderes Team ist dafür verantwortlich oder viele Skripte hängen von ihren Namen ab.

Der Adapter leitet jeden Aufruf weiter und wandelt dabei die Daten um, hier zwei Zahlen in einen Prozentwert. Multipliziere vor dem Dividieren: Bei Ganzzahlen ergibt 30 / 120 * 100 den Wert 0, während 30 * 100 / 120 den Wert 25 ergibt.