Saltar al contenido

Módulos

API de almacenamiento

Guarda registros versionados con compare-and-set mediante PersistenceService y usa el Redis compartido con RedisService.

PersistenceService

Los registros tienen namespace, clave, revisión y un payload binario inmutable; tu módulo define y versiona el formato del payload. La misma semántica se aplica en MongoDB, MySQL, MariaDB y SQLite.

ReglaValor
Namespace1–64 letras, dígitos, ., -, _ ASCII
Clave1–191 letras, dígitos, _ : . / - ASCII
PayloadHasta 1 MiB
Tamaño de página1–1000 registros, ordenados por clave, afterKey exclusivo
  • putAsync(ns, key, -1, payload) inserta con revisión 0 y devuelve false si el registro existe.
  • Las actualizaciones y borrados exigen la revisión leída; false indica un conflicto, no una excepción.
  • Cada mutación es atómica para un registro. No hay transacciones de varios registros.
  • Las lecturas van primero a Redis y rellenan la caché desde la base de datos.

RedisService

get, set, delete, incremento atómico con caducidad, publicación y suscripción, cada uno con variantes async y síncronas. set e increment exigen un TTL de 1–31536000 segundos. El prefijo de la red se añade automáticamente. Hasta 64 listeners de suscripción por servidor; el pub/sub es transitorio y no es un almacenamiento durable.