Lua Academy · Lektion

Plugin-API og hook-system

Definér en plugin-API-tabel, og registrér hooks til livscyklushændelser.

Lektion 2 af 413 trin

Plugin-API og hook-system er en gratis Lua Academy-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Lua Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Lua Academy-kurset indeholder 4 lektioner i alt.

Hvad er et hooksystem?

Et hooksystem gør det muligt for plugins at registrere tilbagekald til bestemte hændelser i applikationens livscyklus. Applikationen kalder alle registrerede hooks på det rette tidspunkt.

Applikationsobjektet

Applikationsobjektet sendes til plugins under initialiseringen. Det stiller API'et til registrering af hooks til rådighed.

local App = {}
App.__index = App
App._hooks = {}
function App:on(event, fn)
  self._hooks[event] = self._hooks[event] or {}
  table.insert(self._hooks[event], fn)
end
function App:emit(event, ...)
  for _, fn in ipairs(self._hooks[event] or {}) do
    fn(...)
  end
end

Plugin registrerer hooks

Et plugins init-funktion modtager applikationen og registrerer hooks.

-- plugins/auth.lua
return {
  name = "auth",
  init = function(app)
    app:on("request", function(req)
      if not req.headers.token then
        error("Unauthorized")
      end
    end)
  end
}

Hookprioriteter

Giv plugins mulighed for at angive en prioritet, så kritiske hooks (f.eks. godkendelse) kører før valgfrie hooks (f.eks. logning).

function App:on(event, fn, priority)
  priority = priority or 50
  local hooks = self._hooks[event] or {}
  hooks[#hooks+1] = {fn=fn, priority=priority}
  table.sort(hooks, function(a,b) return a.priority < b.priority end)
  self._hooks[event] = hooks
end

Returværdier fra hooks

Nogle hooks returnerer værdier, der ændrer adfærden. Applikationen kan afbryde ved den første returværdi, der ikke er nil.

function App:filter(event, data)
  for _, fn in ipairs(self._hooks[event] or {}) do
    local result = fn(data)
    if result ~= nil then return result end
  end
  return data
end

Afregistrering af hooks

Tilbyd en :off(event, fn)-metode til at fjerne et bestemt hook ved hjælp af en funktionsreference.

Navneområder for hooks

Brug hændelsesnavne med punktummer for at skabe struktur: "request.before", "request.after", "db.query".

Kommandoer leveret af plugins

Ud over hooks kan plugins registrere navngivne kommandoer, som applikationen eller andre plugins kan kalde.

function App:registerCommand(name, fn)
  self._commands = self._commands or {}
  self._commands[name] = fn
end
function App:run(name, ...)
  local cmd = self._commands[name]
  if cmd then return cmd(...) end
  error("Unknown command: " .. name)
end

Middlewaremønsteret

Hookkæder kan danne en middleware-stak, hvor hvert hook kalder det næste, så transformation af anmodninger og svar gennem behandlingskæder bliver mulig.

Test af plugins isoleret

Opret et mock-applikationsobjekt i tests for at kontrollere, at pluginets hooks registreres og kaldes korrekt.

Dokumentationskonvention

Dokumentér alle tilgængelige hooknavne, deres argumenter og forventede returværdier. Det udgør plugin-kontrakten, som tredjepartsudviklere er afhængige af.

Spørgsmål om hooksystemet

Hvad er formålet med prioritet i et hooksystem?

Besvar den i den interaktive lektion

Opsummering: Plugin-API og hooksystem

Stil et API til registrering af :on(event, fn) til rådighed på applikationsobjektet. Udsend hændelser med :emit(). Tilføj prioritet for at styre rækkefølgen af udførelsen. Brug hændelsesnavne med navneområder, og dokumentér hook-kontrakten for pluginudviklere.

Gratis at komme i gang

Lær Lua med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser: 40
Lektioner: 159

Start gratis Se hele kurset

Ofte stillede spørgsmål

Er lektionen “Plugin-API og hook-system” gratis?

Ja — alle 3 lektioner i læringssporet Lua Academy, inklusive “Plugin-API og hook-system”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Lua Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Plugin-API og hook-system”?

Definér en plugin-API-tabel, og registrér hooks til livscyklushændelser. Du øver dig i Lua Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Lua Academy?

Der kræves ingen tidligere erfaring. Lua Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.

Hvor lang tid tager lektionen “Plugin-API og hook-system”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Lua Academy-lektion?

Ja. Alle Lua Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

← Tilbage til Lua Academy