Interface UserCalendar
Un agenda utilisateur est un bean session sans état défini par l'utilisateur, qui est appelé par les tâches lorsque celles-ci doivent calculer des valeurs liées à la date.
com.ibm.websphere.scheduler.UserCalendarHome com.ibm.websphere.scheduler.UserCalendar
Le bean proprement dit doit implémenter les méthodes applyDelta(), validate() et getCalendarNames() définies dans l'interface distante. Pour plus de détails, voir la rubrique Interface UserCalendar dans la documentation sur les API.
Les agendas utilisateur permettent de calculer des intervalles de temps, tels que le délai entre les exécutions d'une tâche. Un agenda utilisateur utilise un objet java.util.Date, applique la chaîne d'intervalle et renvoie le java.util.Date qui en résulte.
Les agendas utilisateur sont définis par la méthode setUserCalendar() sur l'interface TaskInfo et appelés par le code d'exécution du planificateur lorsqu'un calcul delta est nécessaire.
- setStartTimeInterval
- setStartByInterval
- setRepeatInterval
- Agenda utilisateur par défaut
- Si aucun agenda utilisateur n'a été spécifié à l'aide de la méthode TaskInfo.setUserCalendar(), un agenda utilisateur par défaut est utilisé. L'agenda par défaut admet des spécifications de delta simples, telles que les secondes, les minutes, les heures, les jours et les mois. Pour plus de détails sur l'agenda par défaut, consultez la documentation sur les API. L'agenda utilisateur (user calendar) par défaut fournit une syntaxe de type CRON pour le calcul des temps absolus par rapport aux retardements.
- Identificateurs d'agendas
- Un agenda utilisateur unique peut contenir la logique de plusieurs agendas. Une chaîne de spécification d'agenda détermine l'agenda utilisé. Par exemple, il se peut qu'un bean calendar soit implémenté pour reconnaître l'intervalle jour. L'identificateur reconnaît toutefois également deux implémentations d'agendas : standard (pour un jour calendaire standard) et business (pour un jour ouvrable).
- Internationalisation et fuseaux horaires
- Scheduler utilise la classe java.util.Date lors du stockage et du traitement des dates. En interne, cette classe sauvegarde l'heure sous forme de millisecondes à partir de la valeur epoch, GMT (Greenwich Mean Time). Dans la mesure où la date n'est pas convertie en heure locale tant qu'elle n'est pas convertie en chaîne, le planificateur respecte le fuseau horaire dans lequel la date a été créée.
- Ecriture d'agendas utilisateur
- Dans la mesure où user calendar (agenda utilisateur) est un bean session sans état, le même modèle de programmation Java EE (Java Platform, Enterprise Edition) accessible aux autres beans session est disponible également pour l'agenda utilisateur.