Padrão Decorator

O padrão Decorator adiciona comportamento a um objeto envolvendo-o em outro objeto com os mesmos métodos. Cada wrapper chama o objeto dentro dele e adiciona sua própria parte, e os wrappers podem ser encadeados em qualquer ordem.

# weapon.gd
class_name Weapon
extends RefCounted

func get_damage() -> int:
	return 10

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

Um decorador estende Weapon, então pode ser usado onde se espera uma arma, e mantém a arma que envolve:

# 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 é escrito da mesma forma, mas seu get_damage() retorna inner.get_damage() * 2 e seu describe() adiciona " + 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

As chamadas seguem para dentro: SharpEnchant pergunta a FireEnchant, que pergunta à espada. A espada retorna 10, o fogo transforma esse valor em 15, e o afiado dobra esse valor para 30. Na outra ordem, FireEnchant.new(SharpEnchant.new(Weapon.new())), o dano é 10 * 2 + 5, ou seja, 25.

Sem decoradores, cada combinação precisaria de sua própria subclasse: FireSword, SharpSword, FireSharpSword e assim por diante. Com eles, duas classes pequenas abrangem todas as combinações, e um novo encantamento exige apenas mais um arquivo.