Lua Academy · Oppitunti

Määritys-DSL:n rakentaminen

Luokaa deklaratiivinen määrityskieli, joka ladataan dofile()-funktiolla hiekkalaatikossa.

Oppitunti 3/413 vaihetta

Määritys-DSL:n rakentaminen on ilmainen Lua Academy-oppitunti CoddyKitissä. Tämä on oppitunti 3/4. Voit lukea tästä oppimispolusta kokonaan mitkä tahansa 3 oppituntia ilmaiseksi — sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä käytännön harjoittelun sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Oppitunti kuuluu Lua Academy-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. Lua Academy-kurssilla on yhteensä 4 oppituntia.

Tavoite: deklaratiivinen konfiguraatio

Konfiguraatio-DSL:n avulla käyttäjät voivat ilmaista asetukset luettavalla, deklaratiivisella tavalla ja hyödyntää samalla Luan kaikkia ominaisuuksia (ehtolauseita, silmukoita ja funktioita) taustalla.

Konfiguraatiofunktiomalli

Tarjotkaa config(tbl)-funktio, joka validoi ja tallentaa asetukset. Kutsukaa sitä taulukkoliteraalilla, jotta syntaksi pysyy selkeänä.

local function config(tbl)
  -- validate and store
  return tbl
end
-- config.lua:
return config {
  host = "localhost",
  port = 8080,
  debug = os.getenv("DEBUG") == "1",
}

Sisäkkäinen konfiguraatio osioineen

Tukekaa sisäkkäisiä osioita asetusten järjestelmällistä määrittelyä varten.

return config {
  database = { host="db.local", port=5432 },
  cache    = { host="cache.local", ttl=300 },
  logging  = { level="INFO", file="/var/log/app.log" },
}

Aputoiminnot konfiguraatiossa

Sallikaa apufunktioiden kutsuminen konfiguraation sisällä laskettujen arvojen muodostamista varten.

local function env(name, default)
  return os.getenv(name) or default
end
return config {
  host  = env("DB_HOST", "localhost"),
  port  = tonumber(env("DB_PORT", "5432")),
}

Konfiguraation lataaminen hiekkalaatikossa

Turvallisuussyistä ladatkaa konfiguraatio rajoitetussa ympäristössä, jossa sallitaan vain turvalliset apufunktiot.

local function loadConfig(path)
  local safeEnv = {
    config = config,
    env    = env,
    math   = math,
    table  = table,
  }
  local fn, err = loadfile(path, "t", safeEnv)
  if not fn then error(err) end
  return fn()
end

Skeeman validointi

Validoikaa pakolliset kentät ja tyypit lataamisen jälkeen.

local function validate(cfg)
  assert(type(cfg.host) == "string", "host must be string")
  assert(type(cfg.port) == "number", "port must be number")
  assert(cfg.port > 0 and cfg.port < 65536, "port out of range")
end
validate(loadConfig("config.lua"))

Oletusarvot

Yhdistäkää ladattu konfiguraatio oletusarvoihin varmistaaksenne, että kaikilla pakollisilla avaimilla on arvo.

local defaults = {host="localhost", port=8080, debug=false}
local function loadWithDefaults(path)
  local cfg = loadConfig(path)
  for k, v in pairs(defaults) do
    if cfg[k] == nil then cfg[k] = v end
  end
  return cfg
end

Ympäristömuuttujien ohitukset

Sallikaa ympäristömuuttujien ohittaa asetustiedoston arvot — tämä on välttämätöntä 12-factor-sovellusten suunnittelussa.

Konfiguraation periytyminen

Ladatkaa peruskonfiguraatio ja yhdistäkää sen päälle ympäristökohtainen konfiguraatio (kehitys, staging, tuotanto).

Muuttumaton konfiguraatio

Lataamisen jälkeen jäädyttäkää konfiguraatiotaulukko määrittämällä __newindex siten, että se aiheuttaa virheen. Näin estätte tahattoman muuttamisen ajonaikana.

Konfiguraation dokumentointi

Käyttäkää kommentteja ja jäsenneltyjä avainten nimiä itseään dokumentoivina rakenteina. Hyvin suunniteltu konfiguraatio-DSL on DevOps-tiimeille itsestään selvä.

Kysymys konfiguraatio-DSL:stä

Miksi asetustiedosto ladataan hiekkalaatikossa olevan _ENV-ympärön avulla?

Vastaa interaktiivisessa oppitunnissa

Kertaus: konfiguraatio-DSL:n rakentaminen

Tarjotkaa config(tbl)-funktio. Tukekaa sisäkkäisiä osioita ja apufunktioita. Ladatkaa konfiguraatio hiekkalaatikkoympäristössä. Validoikaa pakolliset kentät ja tyypit. Tarjotkaa oletusarvot ja sallikaa ympäristömuuttujien ohitukset 12-factor-yhteensopivuutta varten.

Aloita maksutta

Opi Lua tekoälytuutorin avulla — ilmaiseksi

Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.

Kurssit: 40
Oppitunnit: 159

Aloita opiskelu maksutta Näytä koko kurssi

Usein kysytyt kysymykset

Onko oppitunti ”Määritys-DSL:n rakentaminen” ilmainen?

Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa Lua Academy-oppimispolun 3 oppituntia, myös oppitunnin “Määritys-DSL:n rakentaminen”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Lua Academy-kurssilla on yhteensä 4 oppituntia.

Mitä opin oppitunnilla ”Määritys-DSL:n rakentaminen”?

Luokaa deklaratiivinen määrityskieli, joka ladataan dofile()-funktiolla hiekkalaatikossa. Harjoittelet Lua Academy-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.

Tarvitsenko kokemusta aloittaakseni Lua Academy-opiskelun?

Aiempi kokemus ei ole tarpeen. CoddyKitin Lua Academy-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 3/4.

Kuinka kauan ”Määritys-DSL:n rakentaminen”-oppitunnin suorittaminen kestää?

Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.

Voinko kirjoittaa ja suorittaa koodia tällä Lua Academy-oppitunnilla?

Kyllä. Jokainen Lua Academy-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.

Kaikki tämän kurssin oppitunnit

DSL-suunnittelun periaatteet Luassa
Operaattorien ylikuormitus sujuvaa DSL:ää varten
Määritys-DSL:n rakentaminen
Yksinkertainen lausekejäsennin

← Takaisin: Lua Academy