Eventos y actualizaciones 24.00

Abrir en ChatGPT

Los eventos de Repository te permiten reaccionar a cambios de datos. Más allá de las actualizaciones automáticas de la UI, puedes escuchar cambios para disparar lógica personalizada.

Ciclo de vida del evento Repository

Cada llamada a commit() genera un RepositoryCommitEvent. Este evento transporta información sobre lo que cambió:

repository.onCommit(event -> {
    // Obtener todas las entidades comprometidas
    List<Customer> commits = event.getCommits();
    
    // Verificar si es una actualización de entidad única
    if (event.isSingleCommit()) {
        Customer updated = event.getFirstCommit();
        System.out.println("Actualizado: " + updated.getName());
    }
});

El evento te informa:

• getCommits() - Lista de entidades que fueron comprometidas
• isSingleCommit() - Si esta fue una actualización dirigida de entidad única
• getFirstCommit() - Método de conveniencia para obtener la primera (o única) entidad

Para commit() sin parámetros, el evento contiene todas las entidades actualmente en el repositorio después de filtrar.

Estrategias de actualización

Las dos firmas de commit sirven para diferentes propósitos:

// Actualización de entidad única - eficiente para cambios individuales
Customer customer = customers.get(0);
customer.setStatus("VIP");
repository.commit(customer);

// Actualización masiva - eficiente para múltiples cambios
products.clear();
products.addAll(loadProductsFromCsv());
repository.commit();

Los commits de entidad única son quirúrgicos: le dicen a los componentes conectados exactamente qué fila cambió. La Table puede actualizar solo las celdas de esa fila sin tocar nada más.

Los commits masivos actualizan todo. Úsalos cuando:

• Múltiples entidades cambiaron
• Agregaste o eliminaste elementos
• No estás seguro de qué cambió

Patrones de UI reactiva

Los eventos de Repository te permiten mantener las visualizaciones resumen en sincronía con tus datos:

// Etiquetas que se actualizan automáticamente
repository.onCommit(event -> {
    double total = sales.stream().mapToDouble(Sale::getAmount).sum();
    totalLabel.setText(String.format("Total: $%.2f", total));
    countLabel.setText("Ventas: " + sales.size());
});

// Conteos de resultados en vivo
repository.onCommit(e -> {
    long count = repository.findAll().count();
    resultsLabel.setText(count + " productos encontrados");
});

Estos escuchadores se activan en cada commit, ya sea por acciones del usuario, importaciones de datos o actualizaciones programáticas. El evento te da acceso a las entidades comprometidas, pero a menudo recalcularás desde la colección fuente para incluir todos los datos actuales.

Manejo de memoria

Los escuchadores de eventos mantienen referencias a tus componentes. Si no los eliminas, el Repository mantiene tus componentes en memoria incluso después de que ya no se muestran:

// Mantener referencia para eliminar más tarde
ListenerRegistration<RepositoryCommitEvent<Data>> registration = 
    repository.onCommit(event -> {
        updateDisplay(event.getCommits());
    });

// Limpiar el escuchador cuando el componente es destruido
if (registration != null) {
    registration.remove();
}

El método onCommit() retorna un ListenerRegistration. Guarda esta referencia y llama a remove() cuando tu componente sea destruido o ya no necesite actualizaciones. Esto previene fugas de memoria en aplicaciones de larga ejecución.