Wzorzec kompozytu

Wzorzec Composite tworzy drzewa, w których pojedynczy obiekt i grupa obiektów mają te same metody, dzięki czemu kod może traktować całą grupę jak jeden element. Torba zawiera przedmioty, może zawierać inne torby, a o wagę każdej z nich pytasz w ten sam sposób.

Oba rodzaje mają wspólną klasę abstrakcyjną:

# entry.gd
@abstract
class_name Entry
extends RefCounted

var entry_name: String

@abstract func get_weight() -> int
@abstract func display(indent: String) -> void

Liść jest pojedynczym elementem:

# item.gd
class_name Item
extends Entry

var weight: int

func _init(n: String, w: int) -> void:
	entry_name = n
	weight = w

func get_weight() -> int:
	return weight

func display(indent: String) -> void:
	print(indent, entry_name, " (", weight, ")")

Kontener złożony przechowuje inne elementy i odpowiada, pytając każdy z nich. Sam worek waży 1:

# bag.gd
class_name Bag
extends Entry

var contents: Array[Entry] = []

func _init(n: String) -> void:
	entry_name = n

func add(entry: Entry) -> void:
	contents.append(entry)

func get_weight() -> int:
	var total := 1
	for entry in contents:
		total += entry.get_weight()
	return total

func display(indent: String) -> void:
	print(indent, entry_name, " [", get_weight(), "]")
	for entry in contents:
		entry.display(indent + "  ")

# main.gd
var pouch := Bag.new("Pouch")
pouch.add(Item.new("Gem", 2))
var backpack := Bag.new("Backpack")
backpack.add(Item.new("Sword", 8))
backpack.add(pouch)
backpack.display("")

Backpack [12]
  Sword (8)
  Pouch [3]
    Gem (2)

Bag.get_weight() nigdy nie sprawdza, czy wpis jest przedmiotem, czy torbą: wywołuje tę samą metodę dla każdego z nich, a znajdująca się w środku torba odpowiada, pytając o własną zawartość. Ta rekurencja przechodzi przez całe drzewo, niezależnie od jego głębokości.

Łącza prowadzą tylko w jedną stronę — od torby do jej zawartości. Gdyby każdy wpis przechowywał również informację o torbie, w której się znajduje, każda torba i jej wpisy wskazywałyby na siebie nawzajem, tworząc cykl odwołań, który nigdy nie zostanie zwolniony. Gdy wpis musi wiedzieć, gdzie się znajduje, przekaż tę informację jako argument, tak jak display() przekazuje wcięcie.