#2778 : `CalendarResponse.java`

projectforge-wicket/src/main/java/net/ftlines/wicket/fullcalendar/CalendarResponse.java Constructeur de réponse Java (commandes Ajax FullCalendar) · projectforge-wicket/src/main/java/net/ftlines/wicket/fullcalendar/CalendarResponse.java 110 lignes · 48 code · 43 commentaires · 19 vides

Une API fluide pour envoyer des commandes du serveur Wicket au client JavaScript FullCalendar en réponse aux rappels Ajax. Chaque méthode compose une invocation JavaScript basée sur jQuery ciblant l'élément DOM du calendrier ($('#calendarId').fullCalendarExt("commande", args...)) et l'ajoute à AjaxRequestTarget de Wicket. Il s'agit du canal de commande serveur-vers-client pour la manipulation du calendrier : rafraîchir les événements, basculer la visibilité des sources d'événements, supprimer des événements, naviguer vers des dates et effacer les sélections — le tout piloté par des gestionnaires d'événements côté serveur qui réagissent aux interactions utilisateur.

Architecture

Modèle de constructeur de commandes

Chaque méthode publique retourne CalendarResponse pour le chaînage. Le modèle permet de composer plusieurs commandes de calendrier dans un seul gestionnaire de rappel :

response.clearSelection().gotoDate(date).refetchEvents();

Le mécanisme sous-jacent génère des chaînes JavaScript via execute(args...), qui utilise String.format pour produire un sélecteur jQuery ciblant l'ID de marquage Wicket du calendrier, et ajoute le JavaScript à AjaxRequestTarget. L'assistant q() encapsule les arguments entre guillemets simples (ou produit null pour les valeurs nulles).

Commandes disponibles

refetchEvents() — demande à FullCalendar de recharger les données d'événements depuis toutes les sources
refetchEvents(EventSource) — recharge une source d'événements spécifique en la désactivant puis en la réactivant
refetchEvent(EventSource, Event) — espace réservé pour un rafraîchissement optimisé d'un seul événement (actuellement revient à un rafraîchissement complet de la source avec un commentaire TODO)
toggleEventSource(EventSource, boolean) — active ou désactive la case à cocher de visibilité d'une source d'événements
removeEvent(Event) — supprime un événement spécifique du calendrier
gotoDate(Date) — navigue la vue du calendrier vers une date spécifique
clearSelection() — efface la sélection de plage de dates mise en évidence

Note d'architecture : Optimisation d'un seul événement

La méthode refetchEvent contient un commentaire TODO reconnaissant l'implémentation actuelle non optimisée (rechargement complet de la source). Le commentaire décrit l'optimisation prévue : rechercher l'événement affecté dans le tampon côté client et ne recharger que cet événement. Il s'agit d'un TODO de performance reconnu pour les calendriers comportant de nombreux événements.

Historique Git