Mẫu lệnh

Mẫu Command biến một hành động thành một đối tượng. Đối tượng này lưu trữ mọi thứ cần thiết để thực hiện hành động, vì vậy bạn có thể giữ nó trong một danh sách, thực hiện sau hoặc hoàn tác.

Mỗi lệnh đều có cùng hai phương thức, được khai báo trong một lớp cha trừu tượng:

# command.gd
@abstract
class_name Command
extends RefCounted

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

Một lệnh cụ thể lưu đối tượng mà lệnh tác động đến, gọi là đối tượng nhận, cùng dữ liệu của hành động. Ở đây, đối tượng nhận là một Hero có 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

Đối tượng gọi lệnh chạy các lệnh và ghi nhớ chúng. Nó không cần biết lệnh thực hiện việc gì:

# 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

Lịch sử là một ngăn xếp (stack): pop_back() lấy lệnh mới nhất, nên thao tác hoàn tác sẽ lần lượt quay lại các hành động theo thứ tự ngược lại. Những đối tượng này cũng cho phép bạn gán lại phím (key rebinding), phát lại (chạy lại danh sách đã lưu) và xếp hàng lượt.

Các tham chiếu chỉ đi theo một chiều: các lệnh tham chiếu đến nhân vật chính, còn nhân vật chính không biết gì về chúng. Nếu nhân vật chính cũng lưu các lệnh, các đối tượng sẽ giữ cho nhau tồn tại và không bao giờ được giải phóng.