Patron Décorateur

Le motif Décorateur ajoute un comportement à un objet en l’enveloppant dans un autre objet possédant les mêmes méthodes. Chaque enveloppe appelle l’objet qu’elle contient et ajoute sa propre contribution, et les enveloppes peuvent être empilées dans n’importe quel ordre.

# weapon.gd
class_name Weapon
extends RefCounted

func get_damage() -> int:
	return 10

func describe() -> String:
	return "Sword"

Un décorateur étend Weapon, il peut donc être utilisé partout où une arme est attendue, et il contient l’arme qu’il enveloppe :

# fire_enchant.gd
class_name FireEnchant
extends Weapon

var inner: Weapon

func _init(wrapped: Weapon) -> void:
	inner = wrapped

func get_damage() -> int:
	return inner.get_damage() + 5

func describe() -> String:
	return inner.describe() + " + Fire"

SharpEnchant s’écrit de la même manière, mais son get_damage() renvoie inner.get_damage() * 2 et son describe() ajoute " + Sharp".

# main.gd
var weapon: Weapon = Weapon.new()
print(weapon.describe(), ": ", weapon.get_damage())
weapon = FireEnchant.new(weapon)
weapon = SharpEnchant.new(weapon)
print(weapon.describe(), ": ", weapon.get_damage())

Sword: 10
Sword + Fire + Sharp: 30

Les appels se propagent vers l’intérieur : SharpEnchant interroge FireEnchant, qui interroge l’épée. L’épée renvoie 10, le feu le porte à 15, et l’effet tranchant le double pour atteindre 30. Dans l’autre ordre, FireEnchant.new(SharpEnchant.new(Weapon.new())), les dégâts sont de 10 * 2 + 5, soit 25.

Sans décorateurs, chaque combinaison nécessiterait sa propre sous-classe : FireSword, SharpSword, FireSharpSword, et ainsi de suite. Avec eux, deux petites classes couvrent toutes les combinaisons, et un nouvel enchantement ne nécessite qu’un fichier supplémentaire.