Singleton Tablosu

Coddy'nin Lua Journey'sinin Nesne Yönelimli Programlama bölümünün bir parçası — ders 63 / 70.

Bazen tüm programınızda bir şeyin tam olarak bir örneğine ihtiyaç duyarsınız; bir yapılandırma yöneticisi, bir günlük kaydı sistemi veya oyun ayarları gibi. Birden fazla kopya oluşturmak sorunlara yol açar: hangisi doğru veriye sahip? Singleton deseni yalnızca bir örneğin var olmasını sağlar.

Lua'da, modüllerin çalışma şekli sayesinde bir Singleton uygulamak şaşırtıcı derecede basittir. Bir modülü require ettiğinizde, Lua sonucu önbelleğe alır. require fonksiyonuna yapılan sonraki çağrılar, yeni bir tablo değil, önbelleğe alınmış tabloyu döndürür.

-- GameConfig.lua
local GameConfig = {
    volume = 80,
    difficulty = "normal"
}

function GameConfig:setVolume(v)
    self.volume = v
end

return GameConfig

Artık, programınızın herhangi bir yerinde:

local config1 = require("GameConfig")
local config2 = require("GameConfig")

config1:setVolume(50)
print(config2.volume)  -- 50 (aynı tablo!)

Hem config1 hem de config2 tam olarak aynı tabloya başvurur. Bir değişken üzerinden yapılan değişiklikler diğeri üzerinden de görülebilir. Bu durum otomatik olarak gerçekleşir çünkü Lua'nın require fonksiyonu döndürülen değeri package.loaded içinde saklar ve onu tekrar kullanır.

Yeni nesneler oluşturan Factory deseninin aksine, bir Singleton tüm uygulamanız genelinde paylaşılan bir durumu garanti eder. Bu, kodunuzun birden fazla bölümünün tutarlı bir şekilde erişmesi ve değiştirmesi gereken global ayarlar için idealdir.

Görev

Kolay

Singleton desenini kullanarak bir oyun ayarları yöneticisi oluşturalım! Programınızın her parçasının, kaç kez çağrılırsa çağrılsın, tam olarak aynı ayarlara erişmesini sağlayan bir yapılandırma modülü oluşturacaksınız.

Kodunuzu iki dosya halinde düzenleyeceksiniz:

GameSettings.lua: Oyun yapılandırmasını saklayan bir Singleton modülü oluşturun. Ayarlar tablonuz musicVolume (70 ile başlar), sfxVolume (100 ile başlar) ve difficulty ("normal" ile başlar) içermelidir. Bu ayarları değiştirmek için üç yöntem ekleyin: :setMusicVolume(value), :setSfxVolume(value) ve :setDifficulty(level). Modülün sonunda tabloyu döndürmeyi unutmayın!
main.lua: GameSettings modülünüzü iki farklı değişkene çağırarak (require) Singleton'ın çalıştığını kanıtlayın. Müzik sesini ve zorluğu değiştirmek için birinci değişkeni kullanın. Ardından, üç ayarın tamamını yazdırmak için ikinci değişkeni kullanın; eğer Singleton doğru çalışıyorsa, her iki değişken de aynı tabloya başvurur, bu nedenle biri üzerinden yapılan değişiklikler diğeri üzerinden görülebilir.

İki girdi alacaksınız:

Yeni müzik sesi (bir sayı)
Yeni zorluk seviyesi ("easy" veya "hard" gibi bir dize)

Ayarları birinci değişken üzerinden değiştirdikten sonra, ikinci değişkeni kullanarak üç ayarı şu sırayla her biri kendi satırında olacak şekilde yazdırın: müzik sesi, sfx sesi ve ardından zorluk.

Örneğin, girdiler 50 ve hard ise, çıktı şöyle olmalıdır:

50
100
hard

Girdiler 25 ve easy ise, çıktı şöyle olmalıdır:

25
100
easy

Sfx sesinin hiç değiştirmediğimiz için varsayılan değeri olan 100'de kaldığına, ancak müzik sesi ve zorluğun birinci değişken üzerinden yapılan değişiklikleri yansıttığına dikkat edin; bu, her iki değişkenin de aynı Singleton örneğine işaret ettiğini kanıtlar!

Kendin dene

-- main.lua - Singleton desenini göster

-- Girdileri oku
local newMusicVolume = tonumber(io.read())
local newDifficulty = io.read()

-- TODO: GameSettings modülünü bir değişkene aktar (örneğin, settings1)

-- TODO: GameSettings modülünü TEKRAR FARKLI bir değişkene aktar (örneğin, settings2)
-- (Eğer Singleton doğru çalışıyorsa, her iki değişken de aynı tabloyu referans alır!)

-- TODO: İLK değişkeni şunları yapmak için kullan:
--   - Müzik sesini newMusicVolume olarak ayarla
--   - Zorluğu newDifficulty olarak ayarla

-- TODO: Ayarları yazdırmak için İKİNCİ değişkeni kullan
-- Her birini kendi satırında yazdır: musicVolume, sfxVolume, difficulty