Interfaz UserCalendar

Un calendario de usuario es un bean de sesión sin estado definido por el usuario al que las tareas llaman cuando necesitan calcular valores relacionados con fechas.

Un bean calendario de usuario utiliza las siguientes interfaces de inicio y remotas, definidas en el descriptor de despliegue utilizando una herramienta de ensamblaje, como Rational Application Developer:
com.ibm.websphere.scheduler.UserCalendarHome
com.ibm.websphere.scheduler.UserCalendar

El propio bean necesita implementar los métodos applyDelta(), validate() y getCalendarNames() definidos en la interfaz remota. Para obtener detalles, consulte la interfaz UserCalendar en la documentación de API.

Los calendarios de usuario se utilizan para calcular los intervalos de tiempo, como el tiempo entre ejecuciones de tareas. Un calendario de usuario recibe un objeto java.util.Date, aplica la serie de intervalo y devuelve el objeto java.util.Date resultante.

Los calendarios de usuario se establecen mediante el método setUserCalendar() de la interfaz TaskInfo, y son llamados por el código de ejecución del planificador cuando es necesario realizar un cálculo delta (diferencial).

Los métodos siguientes de la interfaz TaskInfo especifican series delta que utilizan el calendario de usuario para realizar cálculos:
  • setStartTimeInterval
  • setStartByInterval
  • setRepeatInterval
Calendario de usuario predeterminado
Si no se ha especificado un calendario de usuario utilizando el método TaskInfo.setUserCalendar(), se utiliza un calendario de usuario predeterminado. El calendario predeterminado permite especificaciones delta sencillas, como segundos, minutos, horas, días y meses. Consulte la documentación de API para obtener detalles sobre el calendario predeterminado. El calendario de usuario predeterminado también proporciona una sintaxis de tipo CRON para calcular tiempos absolutos respecto a diferenciales de tiempo.
Identificadores de calendario
Un calendario de usuario sencillo puede contener lógica para varios calendarios. La serie de un especificador de calendario determina qué calendario se va a utilizar. Por ejemplo, un bean de calendario puede implementarse para que reconozca el intervalo día. No obstante, el identificador además reconoce dos implementaciones de calendario: standar (para un día de calendario estándar) y business (para un día laborable).
Internacionalización y husos horarios
El planificador hace uso de la clase java.util.Date cuando almacena y procesa fechas. Internamente, esta clase guarda la hora en milisegundos referente a la época actual, considerando la hora media de Greenwich. Como la fecha no se convierte en hora local hasta que se convierte en una serie, el planificador respeta el huso horario en el que se ha creado la fecha.
Escribir calendarios de usuario
Como los calendarios de usuario son un bean de sesión sin estado, el mismo modelo de programación Java EE (Java Platform, Enterprise Edition) disponible en otros bean de sesión también está disponible para el calendario de usuario.

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rsch_usercalendar
File name: rsch_usercalendar.html