Thành viên công khai và riêng tư

Tính đóng gói nghĩa là một đối tượng giữ dữ liệu cùng với các phương thức thay đổi dữ liệu đó, đồng thời quyết định những thành viên nào mà code khác có thể sử dụng. Các thành viên dành cho code khác tạo thành giao diện của đối tượng.

GDScript không có từ khóa public hay private: bạn có thể truy cập mọi thành viên từ bên ngoài. Hướng dẫn phong cách của Godot đánh dấu các thành viên riêng tư bằng dấu gạch dưới ở đầu tên:

# bank_account.gd
class_name BankAccount
extends RefCounted

var owner_name: String
var _balance: int = 0
var _history: Array[String] = []

func _init(holder: String) -> void:
	owner_name = holder

func deposit(amount: int) -> void:
	_balance += amount
	_record("deposit %d" % amount)

func get_balance() -> int:
	return _balance

func _record(entry: String) -> void:
	_history.append(entry)

owner_name, deposit() và get_balance() là các thành phần công khai, nên main.gd sử dụng chúng. _balance, _history và _record() là các thành phần riêng tư: chỉ code bên trong bank_account.gd sử dụng chúng.

# main.gd
var account := BankAccount.new("Ada")
account.deposit(50)
account.deposit(20)
print(account.owner_name) # Ada
print(account.get_balance()) # 70

Dấu gạch dưới là một quy ước, không phải cơ chế khóa: account._balance = 1000000 trong main.gd chạy mà không báo lỗi. Dù vậy, hãy tuân theo quy ước này. Khi chỉ lớp thay đổi _balance, số dư sai chỉ có thể xuất phát từ một phương thức trong bank_account.gd, vì vậy đó là tệp duy nhất bạn cần kiểm tra.

GDScript cũng không có cấp độ protected. Lớp con kế thừa mọi thành viên, kể cả thành viên riêng tư, nên SavingsAccount extends BankAccount có thể dùng _balance trong các phương thức của chính nó.

Các phương thức ảo của Godot, chẳng hạn như _init() và _ready(), cũng bắt đầu bằng dấu gạch dưới. Godot sẽ gọi chúng giúp bạn, vì vậy đừng đặt cùng tên đó cho bất kỳ phương thức riêng tư nào của bạn.