Pattern Composite

Il pattern Composite crea alberi in cui un singolo oggetto e un gruppo di oggetti hanno gli stessi metodi, così il codice può trattare un intero gruppo come un unico elemento. Una borsa contiene oggetti, una borsa può contenere altre borse e puoi chiedere a ciascuna il suo peso nello stesso modo.

Entrambi i tipi condividono un genitore astratto:

# entry.gd
@abstract
class_name Entry
extends RefCounted

var entry_name: String

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

La foglia è un singolo elemento:

# 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, ")")

Il composito contiene altre voci e risponde interrogandole una per una. Una borsa pesa 1 da sola:

# 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() non controlla mai se una voce è un oggetto o una borsa: chiama lo stesso metodo su ciascuna di esse, e una borsa al suo interno risponde chiedendo il peso dei propri contenuti. Questa ricorsione attraversa l'intero albero, per quanto sia profondo.

I collegamenti vanno in una sola direzione, da una cartella ai suoi contenuti. Se ogni elemento memorizzasse anche la cartella in cui si trova, ogni cartella e i suoi elementi punterebbero gli uni agli altri, creando un ciclo di riferimenti che non viene mai liberato. Quando un elemento ha bisogno di sapere dove si trova, passa questa informazione come argomento, proprio come display() passa il rientro.