EN · DE · RU · FR · ES

#2785: EventSourceNotFoundException.java

projectforge-wicket/src/main/java/net/ftlines/wicket/fullcalendar/EventSourceNotFoundException.java Excepción Java (Dominio FullCalendar) · projectforge-wicket/src/main/java/net/ftlines/wicket/fullcalendar/EventSourceNotFoundException.java 44 líneas · 6 código · 33 comentarios · 5 en blanco
Una excepción runtime tipada que se lanza cuando EventManager no puede localizar una fuente de eventos por su UUID. Esta es la excepción de primer nivel en la jerarquía de fallos de búsqueda de dos niveles. Ocurre cuando una devolución de llamada Ajax de FullCalendar contiene un UUID de fuente que no coincide con ninguna de las fuentes de eventos configuradas en el calendario — lo que típicamente indica un estado de cliente obsoleto (por ejemplo, una fuente de eventos fue eliminada del lado del servidor pero la configuración en caché del cliente aún la referencia), o un error del lado del cliente al enviar un UUID corrupto. Extiende RuntimeException para una integración fluida con el manejo de excepciones de devoluciones de llamada Ajax de Wicket.

Arquitectura

Jerarquía de excepciones

Esta excepción y EventNotFoundException (archivo #2782) forman una jerarquía de fallos diferenciada en lugar de usar una única excepción genérica con un código de error. La distinción permite que los manejadores implementen diferentes estrategias de recuperación: para una fuente faltante, el manejador podría eliminar los eventos de la fuente del cliente; para un evento faltante, podría revertir el evento específico a su posición anterior. Ambas son hermanas que extienden RuntimeException directamente, en lugar de que una herede de la otra, reflejando que representan fallos en diferentes niveles de la cadena de búsqueda.

Mensaje de diagnóstico

El constructor recibe un mensaje formateado como "Fuente de eventos con uuid: {uuid} no encontrada", que es útil para los registros del lado del servidor. El valor UUID ayuda a los operadores a diagnosticar si el problema es una sesión obsoleta (UUID antiguo de una renderización de página anterior) o una solicitud de cliente mal formada.

Historial Git

CommitQué cambió
868d6abb7 a ceb63e8a1Seis actualizaciones anuales del encabezado de derechos de autor. La clase de excepción permanece en su forma original — el diseño de un solo constructor y solo mensaje satisface todas las necesidades de diagnóstico y recuperación para fallos de búsqueda de fuentes.