EN · DE · RU · FR · ES

#2786: FullCalendar.events.tpl

projectforge-wicket/src/main/java/net/ftlines/wicket/fullcalendar/FullCalendar.events.tpl Plantilla Wicket (callback JavaScript) · projectforge-wicket/src/main/java/net/ftlines/wicket/fullcalendar/FullCalendar.events.tpl 15 líneas · 14 código · 0 comentarios · 1 en blanco
Un recurso PackageTextTemplate de Wicket que define el callback de obtención de eventos JavaScript inyectado en la configuración de cada fuente de eventos de FullCalendar. Este único archivo de plantilla es el puente crítico entre el servidor Wicket y el cliente FullCalendar: genera una función JavaScript que realiza una solicitud GET Ajax de Wicket a una URL generada dinámicamente (única por fuente de eventos), pasando el rango de fechas visible del calendario (inicio/fin como milisegundos epoch), el desplazamiento de zona horaria del cliente y un token anti-caché. La respuesta se pasa directamente al callback de FullCalendar como el arreglo de datos de eventos.

Arquitectura

Procesamiento de la plantilla

La plantilla utiliza la sintaxis de sustitución de variables TextTemplate de Wicket: ${url} es la única variable. En tiempo de renderizado, FullCalendar.setupCallbacks() crea un HashMap con la clave "url" establecida en la URL del callback Ajax de la fuente de eventos (generada por Wicket.Ajax.ajax), y llama a EVENTS.asString(map) para producir el JavaScript final.

Protocolo Ajax

El JavaScript generado realiza una llamada Ajax de Wicket con los parámetros:

Convención de nomenclatura del archivo de plantilla

El PackageTextTemplate de Wicket localiza este archivo por convención: debe estar en el mismo paquete Java (net.ftlines.wicket.fullcalendar) que la clase FullCalendar y tener el mismo nombre base. La extensión .tpl indica que es un recurso de plantilla de texto.

Historial de Git

CommitQué cambió
9ebb88522Se agregó el archivo de plantilla como parte del commit inicial del repositorio. El protocolo Ajax (llamada Ajax de Wicket con marcas de tiempo epoch, desplazamiento de zona horaria y token anti-caché) se estableció desde el principio y ha permanecido sin cambios — un testimonio de la estabilidad tanto de la API Ajax de Wicket como del protocolo de fuente de eventos de FullCalendar.