fxRetry
Ejecuta de nuevo un efecto inestable hasta que tenga éxito — hasta attempts veces, con backoff opcional entre fallos.
Lección
Los pipelines reales llaman a servicios reales, y los servicios
reales fallan de vez en cuando. La respuesta hecha a mano es un bucle
for con un try/catch, un
contador y un Future.delayed — copiada en cada proyecto,
sutilmente distinta cada vez. fxRetry(attempts, f) es ese
bucle, una sola vez: ejecuta f, y ante un error vuelve a
ejecutarlo, hasta attempts ejecuciones en total; agotado
el presupuesto, el último error se relanza con su stack
trace original. El hook delay recibe el número de fallos
(1, 2, …), así que el backoff es una línea:
delay: (failed) => Duration(seconds: failed).
mapRetry(attempts, f) es la misma idea por elemento: un
map en el que cada llamada tiene
su propio presupuesto de reintentos. Está construido sobre el
fxMapAsync seguro en paralelo, así que bajo
concurrent(n) cada
elemento en curso reintenta de forma independiente — un
elemento lento e inestable se reejecuta mientras sus vecinos avanzan
sin problema, y el orden se sigue preservando. Para reintentar un
pipeline entero, envuelve su terminal:
fxRetry(3, () => fxAsync(…).toList()) — el
resultado parcial se descarta y el pipeline se reejecuta desde un
iterador nuevo.
No todo error merece otra ejecución. retryIf recibe el
error y decide: si devuelve false, se relanza al instante
— sin espera, sin gastar intentos — así que un timeout se reintenta
mientras que un 404 o un error de parseo fallan rápido.
onRetry se llama con el error y el número de fallos en cada
fallo que sí se va a reintentar, antes de la espera: el sitio
para registrarlo, o para cerrar una conexión rota antes de la siguiente
ejecución. El fallo final no se notifica ahí; es el error con el que
termina la llamada. mapRetry acepta ambos, por elemento.
Extensión de fxdart (sin contraparte en FxTS), inspirada en
retry/retryWhen de Rx — rediseñada para el
modelo pull, donde «resuscribirse» significa «construir el iterable
otra vez». Para un manejo tipado del fallo cuando los
reintentos se agotan, pásale el resultado a
fxEitherCatching.
Demo 1 · Una petición inestable, con backoff
Demo 2 · mapRetry bajo concurrent
Demo 3 · retryIf y onRetry
Pruébalo tú
Ejercicio: haz que la importación sobreviva a sus filas inestables.
timeout — acota cuánto puede tardar cada pull ·
concurrent — los reintentos son independientes por elemento en vuelo ·
errores tipados — cuando el fallo debe ser un valor, no una excepción