Pola Command

Pola Command mengubah sebuah tindakan menjadi object. Object tersebut menyimpan semua yang diperlukan untuk menjalankan tindakan itu, sehingga kamu dapat menyimpannya dalam list, menjalankannya nanti, atau membatalkannya.

Setiap perintah memiliki dua method yang sama, yang dideklarasikan oleh class induk abstrak:

# command.gd
@abstract
class_name Command
extends RefCounted

@abstract func execute() -> void
@abstract func undo() -> void

Perintah konkret menyimpan object yang dikenainya, yang disebut receiver, dan data tindakannya. Di sini receiver-nya adalah Hero dengan var x := 0:

# move_command.gd
class_name MoveCommand
extends Command

var hero: Hero
var dx: int

func _init(target: Hero, step: int) -> void:
	hero = target
	dx = step

func execute() -> void:
	hero.x += dx

func undo() -> void:
	hero.x -= dx

Invoker menjalankan perintah dan mengingatnya. Invoker tidak perlu tahu apa yang dilakukan suatu perintah:

# command_history.gd
class_name CommandHistory
extends RefCounted

var done: Array[Command] = []

func run(command: Command) -> void:
	command.execute()
	done.append(command)

func undo_last() -> void:
	if done.is_empty():
		return
	var last: Command = done.pop_back()
	last.undo()

# main.gd
var hero := Hero.new()
var history := CommandHistory.new()
history.run(MoveCommand.new(hero, 3))
history.run(MoveCommand.new(hero, 2))
print(hero.x)
history.undo_last()
print(hero.x)

5
3

Riwayat ini adalah stack: pop_back() mengambil perintah terbaru, jadi pembatalan berjalan mundur melalui tindakan dalam urutan terbalik. Object yang sama memberimu pengikatan ulang tombol (sebuah tombol dipetakan ke perintah), pemutaran ulang (jalankan list yang disimpan lagi), dan antrean giliran.

Referensi berjalan satu arah: perintah menunjuk ke hero, dan hero tidak mengetahui apa pun tentang perintah tersebut. Jika hero juga menyimpan perintahnya, object-object itu akan saling membuat tetap hidup dan tidak akan pernah dibebaskan.