Patron Adaptateur

Le modèle Adaptateur permet à un objet de fonctionner avec du code qui attend des méthodes différentes. L’adaptateur enveloppe l’objet et transforme chaque appel attendu en un appel que l’objet comprend.

Une ancienne classe d’un projet précédent stocke la santé sous forme de deux nombres :

# old_monster.gd
class_name OldMonster
extends RefCounted

var life := 30
var max_life := 120

Votre HUD affiche tout ce qui possède get_label() et get_hp_percent(). Un Knight possède déjà les deux (il renvoie "Knight" et 80), mais OldMonster ne possède ni l’un ni l’autre :

# health_display.gd
class_name HealthDisplay
extends RefCounted

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

L’adaptateur contient un OldMonster et fournit les deux méthodes appelées par l’affichage :

# 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%

Ni OldMonster ni HealthDisplay n’ont changé. C’est important lorsque vous ne pouvez pas ou ne devez pas modifier une classe : elle provient d’un plug-in, appartient à une autre équipe ou de nombreux scripts dépendent de ses noms.

L’adaptateur transmet chaque appel et convertit les données au passage, ici deux nombres en un pourcentage. Multipliez avant de diviser : avec des entiers, 30 / 120 * 100 vaut 0, tandis que 30 * 100 / 120 vaut 25.