Eventos y actualizaciones 24.00

Abrir en ChatGPT

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

Ciclo de vida del evento Repository

Cada llamada a commit() genera un RepositoryCommitEvent. Este evento lleva 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 una sola entidad
  if (event.isSingleCommit()) {
    Customer updated = event.getFirstCommit();
    System.out.println("Actualizado: " + updated.getName());
  }
});

El evento te dice:

• getCommits() - Lista de entidades que fueron comprometidas
• isSingleCommit() - Si esta fue una actualización específica de una sola entidad
• 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 tienen diferentes propósitos:

// Actualización de una sola entidad - 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 una sola entidad 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:

• Varias entidades cambiaron
• Has agregado o eliminado elementos
• No estás seguro de qué cambió

Patrones de UI reactiva

Los eventos de Repository te permiten mantener las visualizaciones de resumen sincronizadas 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 oyentes 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 de origen para incluir todos los datos actuales.

Gestión de memoria

Los oyentes 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 oyente cuando se destruye el componente
if (registration != null) {
  registration.remove();
}

El método onCommit() devuelve una ListenerRegistration. Almacena esta referencia y llama a remove() cuando tu componente se destruye o ya no necesita actualizaciones. Esto previene fugas de memoria en aplicaciones de larga duración.