واجهة API للإضافات ونظام الخطافات

ما هو نظام الخطافات؟

كائن التطبيق

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

تسجيل الإضافة للخطافات

-- 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
}

أولويات الخطافات

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

القيم المُعادة من الخطافات

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

إلغاء تسجيل الخطافات

تنظيم أسماء الخطافات ضمن مساحات أسماء

الأوامر التي توفرها الإضافات

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

نمط البرمجيات الوسيطة

اختبار الإضافات بمعزل

اصطلاح التوثيق

سؤال حول نظام الخطافات

مراجعة: واجهة برمجة الإضافات ونظام الخطافات