Escuchas del Ciclo de Vida 25.02

Abrir en ChatGPT

La interfaz AppLifecycleListener permite que el código externo observe y reaccione ante eventos del ciclo de vida de la aplicación. Al implementar esta interfaz, puedes ejecutar código en momentos específicos durante el inicio y la detención de la aplicación sin modificar la clase App en sí.

Los escuchas del ciclo de vida son descubiertos y cargados automáticamente en tiempo de ejecución a través de archivos de configuración del proveedor de servicios. Cada instancia de la aplicación recibe su propio conjunto de instancias de escucha, manteniendo el aislamiento entre diferentes aplicaciones que se ejecutan en el mismo entorno.

Cuándo usar escuchas del ciclo de vida

Utiliza los escuchas del ciclo de vida cuando necesites:

• Inicializar recursos o servicios antes de que se ejecute una aplicación
• Limpiar recursos cuando una aplicación termina
• Agregar preocupaciones transversales sin modificar la clase App
• Construir arquitecturas de plugins

La interfaz AppLifecycleListener

AppLifecycleListener.java

public interface AppLifecycleListener {
    default void onWillCreate(Environment env) {}     // Desde 25.03
    default void onDidCreate(App app) {}              // Desde 25.03
    default void onWillRun(App app) {}
    default void onDidRun(App app) {}
    default void onWillTerminate(App app) {}
    default void onDidTerminate(App app) {}
}

Aislamiento de aplicaciones

Cada instancia de aplicación recibe su propio conjunto de instancias de escucha:

• Los escuchas están aislados entre diferentes aplicaciones
• Los campos estáticos en los escuchas no se compartirán entre aplicaciones
• Las instancias de escucha se crean cuando la aplicación se inicia y se destruyen cuando termina

Si necesitas compartir datos entre aplicaciones, utiliza mecanismos de almacenamiento externo como bases de datos o servicios compartidos.

Eventos del ciclo de vida

Evento	Cuándo se llama	Usos comunes
onWillCreate 25.03	Después de la inicialización del entorno, antes de la creación de la aplicación	Modificar configuración, fusionar fuentes de configuración externas
onDidCreate 25.03	Después de la instanciación de la aplicación, antes de la inicialización	Configuración temprana a nivel de aplicación, registrar servicios
onWillRun	Antes de la ejecución de app.run()	Inicializar recursos, configurar servicios
onDidRun	Después de que app.run() se complete con éxito	Iniciar tareas en segundo plano, registrar inicio exitoso
onWillTerminate	Antes de la terminación de la aplicación	Guardar estado, prepararse para el apagado
onDidTerminate	Después de la terminación de la aplicación	Limpiar recursos, registro final

Creando un escucha del ciclo de vida

Implementación básica

StartupListener.java

import com.webforj.App;
import com.webforj.AppLifecycleListener;
import com.webforj.Environment;
import com.typesafe.config.Config;
import com.typesafe.config.ConfigFactory;

public class StartupListener implements AppLifecycleListener {

    @Override
    public void onWillCreate(Environment env) {
        // Modificar la configuración antes de la creación de la aplicación
        Config additionalConfig = ConfigFactory.parseString(
            "myapp.feature.enabled = true"
        );
        env.setConfig(additionalConfig);
    }

    @Override
    public void onDidCreate(App app) {
        System.out.println("Aplicación creada: " + app.getId());
    }

    @Override
    public void onWillRun(App app) {
        System.out.println("Aplicación iniciando: " + app.getId());
    }

    @Override
    public void onDidRun(App app) {
        System.out.println("Aplicación iniciada: " + app.getId());
    }
}

Registro del escucha

Crea un archivo de configuración del proveedor de servicios:

Archivo: src/main/resources/META-INF/services/com.webforj.AppLifecycleListener

com.example.listeners.StartupListener

Usando AutoService

Es fácil olvidar actualizar los descriptores de servicio. Utiliza el AutoService de Google para generar automáticamente el archivo de servicio:

StartupListener.java

import com.google.auto.service.AutoService;

@AutoService(AppLifecycleListener.class)
public class StartupListener implements AppLifecycleListener {
    // Implementación
}

Controlando el orden de ejecución

Cuando se registran múltiples escuchas, puedes controlar su orden de ejecución utilizando la anotación @AppListenerPriority. Esto es particularmente importante cuando los escuchas tienen dependencias entre sí o cuando ciertas inicializaciones deben ocurrir antes que otras.

Los valores de prioridad funcionan en orden ascendente - números más bajos se ejecutan primero. La prioridad predeterminada es 10, por lo que los escuchas sin anotaciones de prioridad explícitas se ejecutarán después de aquellos con valores de prioridad más bajos.

SecurityListener.java

@AutoService(AppLifecycleListener.class)
@AppListenerPriority(1)  // Se ejecuta primero - configuración crítica de seguridad
public class SecurityListener implements AppLifecycleListener {
    @Override
    public void onWillRun(App app) {
        initializeSecurity();
    }
}

@AutoService(AppLifecycleListener.class)
@AppListenerPriority(10) // Prioridad predeterminada - registro general
public class LoggingListener implements AppLifecycleListener {
    @Override
    public void onWillRun(App app) {
        initializeLogging();
    }
}

Flujo de ejecución con ganchos de App

Más allá de controlar el orden entre múltiples escuchas, es importante entender cómo interactúan los escuchas con los propios ganchos del ciclo de vida de la clase App. Para cada evento del ciclo de vida, el marco sigue una secuencia de ejecución específica que determina cuándo se ejecutan tus escuchas en relación con los ganchos incorporados de la aplicación.

El diagrama a continuación ilustra este flujo de ejecución, mostrando el momento preciso en el que se llaman los métodos AppLifecycleListener en relación con los correspondientes ganchos de App:

Manejo de errores

Las excepciones lanzadas por los escuchas se registran, pero no impiden que otros escuchas se ejecuten o que la aplicación funcione. Siempre maneja excepciones dentro de tus escuchas:

Ejemplo de manejo de errores

@Override
public void onWillRun(App app) {
    try {
        riskyInitialization();
    } catch (Exception e) {
        logger.error("La inicialización falló", e);
    }
}