Bus de Eventos
Publicar y suscribirse a eventos a traves de su aplicación para arquitecturas dirigidas por eventos.
Carga
local events = require("events")
Suscribirse a Eventos
Suscribirse a eventos del bus de eventos:
-- Suscribirse a todos los eventos de pedidos
local sub, err = events.subscribe("orders.*")
if err then
return nil, err
end
-- Suscribirse a tipo de evento específico
local sub = events.subscribe("users", "user.created")
-- Suscribirse a todos los eventos de un sistema
local sub = events.subscribe("payments")
-- Procesar eventos
local ch = sub:channel()
while true do
local evt, ok = ch:receive()
if not ok then break end
logger:info("Received event", {
system = evt.system,
kind = evt.kind,
path = evt.path
})
handle_event(evt)
end
| Parámetro | Tipo | Descripción |
|---|---|---|
system |
string | Patrón de sistema (soporta comodines como "test.*") |
kind |
string | Filtro de tipo de evento (opcional) |
Devuelve: Subscription, error
Enviar Eventos
Enviar un evento al bus de eventos:
-- Enviar evento de pedido creado
local ok, err = events.send("orders", "order.created", "/orders/123", {
order_id = "123",
customer_id = "456",
total = 99.99
})
if err then
return nil, err
end
-- Enviar evento de usuario
events.send("users", "user.registered", "/users/" .. user.id, {
user_id = user.id,
email = user.email,
created_at = time.now():format("2006-01-02T15:04:05Z07:00")
})
-- Enviar evento de pago
events.send("payments", "payment.completed", "/payments/" .. payment.id, {
payment_id = payment.id,
order_id = payment.order_id,
amount = payment.amount,
method = payment.method
})
-- Enviar sin datos
events.send("system", "heartbeat", "/health")
| Parámetro | Tipo | Descripción |
|---|---|---|
system |
string | Identificador del sistema |
kind |
string | Tipo/clase del evento |
path |
string | Ruta del evento para enrutamiento |
data |
any | Carga del evento (opcional) |
Devuelve: boolean, error
Metodos de Suscripcion
Obtener el Canal
Obtener el canal para recibir eventos:
local ch = sub:channel()
local evt, ok = ch:receive()
if ok then
print("System:", evt.system)
print("Kind:", evt.kind)
print("Path:", evt.path)
print("Data:", json.encode(evt.data))
end
Campos del evento: system, kind, path, data
Cerrar Suscripcion
Desuscribirse y cerrar el canal:
sub:close()
Permisos
| Accion | Recurso | Descripción |
|---|---|---|
events.subscribe |
sistema | Suscribirse a eventos de un sistema |
events.send |
sistema | Enviar eventos a un sistema |
Errores
| Condición | Tipo | Reintentable |
|---|---|---|
| Sistema vacio | errors.INVALID |
no |
| Tipo vacio | errors.INVALID |
no |
| Ruta vacia | errors.INVALID |
no |
| Politica denegada | errors.INVALID |
no |
Consulte Manejo de Errores para trabajar con errores.