Java > Open Source Codes > org > quartz > UICronTrigger


1
2 /*
3  * Copyright 2004-2005 OpenSymphony
4  *
5  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
6  * use this file except in compliance with the License. You may obtain a copy
7  * of the License at
8  *
9  * http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
13  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
14  * License for the specific language governing permissions and limitations
15  * under the License.
16  *
17  */
18
19 /*
20  * Previously Copyright (c) 2001-2004 James House
21  */
22 package org.quartz;
23
24 import org.quartz.Job;
25 import org.quartz.JobExecutionContext;
26 import org.quartz.JobExecutionException;
27 import org.quartz.Scheduler;
28 import org.quartz.SimpleTrigger;
29 import org.quartz.Trigger;
30 import org.quartz.CronTrigger;
31
32 import java.util.Calendar ;
33 import java.util.Date ;
34 import java.util.HashMap ;
35 import java.util.Iterator ;
36 import java.util.Map ;
37 import java.util.Set ;
38 import java.util.SortedSet ;
39 import java.util.TimeZone ;
40 import java.util.TreeSet ;
41 import java.text.ParseException ;
42
43 /**
44  * <p>
45  * A concrete <code>{@link Trigger}</code> that is used to fire a <code>{@link Job}</code>
46  * at given moments in time, defined with Unix 'cron-like' definitions.
47  * </p>
48  *
49  * <p>
50  * What you should know about this particular trigger is that it is based on
51  * org.quartz.CronTrigger, but the the functionality to build the sets from a
52  * string are unused. Whereas CronTrigger would essentially deserialize by
53  * rebuilding the TreeSets from the cronExpression, this class does not have a
54  * cronExpression, and de/serializes the TreeSets in their entirety. This is
55  * because the TreeSets map directly to the Struts user interface for set
56  * selection, and no effort is made to write an interpreter to map them back
57  * and forth between legacy UN*X cron expressions that CronTrigger uses.
58  * </p>
59  *
60  * <p>
61  * The method I use with this trigger is to instantiate it, then put it in the
62  * ActionForm of a Struts bean, then let Struts manipulate it directly through
63  * BeanUtils. You are by no means required to do that, but to fully understand
64  * the concepts here, at least until there is better documentation, you should
65  * understand how it works within that context first so you can write the
66  * appropriate code that Struts does for you for free. I'll try to explain that
67  * here.
68  * </p>
69  *
70  * <p>
71  * Struts JSP tags allow the user to use Apache BeanUtils to reference
72  * components of beans by path. This is to say that a bean <code>Foo</code>
73  * that has an accessor method <code>Bar getBar()</code> and given <code>
74  * Bar</code>
75  * has a primitive type <code>String</code> as a field named <code>splat</code>,
76  * one can set the field to <i>"new string value"</i> as follows:
77  * </p>
78  * <code>
79  * // create a new Foo with contained reference to a new Bar
80  * Foo fooBean = new Foo();
81  * fooBean.setBar(new Bar());
82  * // set the splat string in the Bar bean from Foo
83  * BeanUtils.setProperty(fooBean, "bar.splat", "new string value");
84  * </code>
85  * <p>
86  * In turn, Struts JSP tags use the bean addressing provided by BeanUtils to
87  * address accessor methods within the bean graph that is rooted with the
88  * ActionForm that is put into the Action context.
89  * </p>
90  * <p>
91  * Finally, having all this allows you to put direct selection lists on the
92  * screen of the UI, then map them directly into the UICronTrigger bean. Given
93  * a ActionForm bean that was set up to contain a <code>UICronTrigger</code>
94  * in a field called <code>trigger</code>, the following HTML code will
95  * completely create your UI in Struts:
96  * </p>
97  *
98  * <code>
99  * <tr class="listRowUnshaded">
100  * <td width="80">Date</td>
101  * <td align="right">
102  * <html:select property="trigger.daysOfWeek" size="5" multiple="true">
103  * <html:options property="trigger.daysOfWeekValues" labelProperty="trigger.daysOfWeekLabels"/>
104  * </html:select>
105  * <html:select property="trigger.daysOfMonth" size="5" multiple="true">
106  * <html:options property="trigger.daysOfMonthValues" labelProperty="trigger.daysOfMonthLabels"/>
107  * </html:select>
108  * <html:select property="trigger.months" size="5" multiple="true">
109  * <html:options property="trigger.monthsValues" labelProperty="trigger.monthsLabels"/>
110  * </html:select>
111  * <html:select property="trigger.years" size="5" multiple="true">
112  * <html:options property="trigger.yearsValues" labelProperty="trigger.yearsLabels"/>
113  * </html:select>
114  * </td>
115  * </tr>
116  * <tr class="listRowShaded">
117  * <td width="80">Time</td>
118  * <td colspan="2" align="right">
119  * <html:select property="trigger.hours" size="5" multiple="true">
120  * <html:options property="trigger.hoursValues" labelProperty="trigger.hoursLabels"/>
121  * </html:select>
122  * <html:select property="trigger.minutes" size="5" multiple="true">
123  * <html:options property="trigger.minutesValues" labelProperty="trigger.minutesLabels"/>
124  * </html:select>
125  * </td>
126  * </tr>
127  * </code>
128  * <p>
129  * So if you don't want to use Struts, what you have to do is take the
130  * information that was submitted on the form in the HTML select ranges,
131  * iterate each of them, and add the values to the appropriate sets in the
132  * fields of this class. Make sense?
133  * </p>
134  *
135  * Note that this is not as versatile as the standard CronTrigger. There are
136  * tricks with "last day of month" and repeating sets that need to be manually
137  * selected, and sets that can happen for date ranges much longer than we can
138  * reasonably map with direct selection in a UI.
139  *
140  * @see org.quartz.CronTrigger
141  * @see Trigger
142  * @see SimpleTrigger
143  *
144  * @author Brian Topping
145  * @author based on code by Sharada Jambula, James House, Mads Henderson
146  * @deprecated
147  */
148 public class UICronTrigger extends Trigger {
149
150     /*
151      * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
152      *
153      * Constants.
154      *
155      * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
156      */
157
158     /**
159      * <p>
160      * Instructs the <code>{@link Scheduler}</code> that upon a mis-fire
161      * situation, the <code>{@link org.quartz.CronTrigger}</code> wants to be
162      * fired now by <code>Scheduler</code>.
163      * </p>
164      */
165     public static final int MISFIRE_INSTRUCTION_FIRE_ONCE_NOW = 1;
166
167     /**
168      * <p>
169      * Instructs the <code>{@link Scheduler}</code> that upon a mis-fire
170      * situation, the <code>{@link org.quartz.CronTrigger}</code> wants to
171      * have it's next-fire-time updated to the next time in the schedule after
172      * the current time, but it does not to be fired now.
173      * </p>
174      */
175     public static final int MISFIRE_INSTRUCTION_DO_NOTHING = 2;
176
177     /*
178      * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
179      *
180      * Data members.
181      *
182      * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
183      */
184     private static final int ALL_SPEC_INT = 99; // '*'
185
186     private static final int NO_SPEC_INT = 98; // '?'
187
188     private static final Integer ALL_SPEC = new Integer (ALL_SPEC_INT);
189
190     private static final Integer NO_SPEC = new Integer (NO_SPEC_INT);
191
192     private static Map monthMap = new HashMap (20);
193
194     private static Map dayMap = new HashMap (60);
195
196     static {
197         monthMap.put("JAN", new Integer (0));
198         monthMap.put("FEB", new Integer (1));
199         monthMap.put("MAR", new Integer (2));
200         monthMap.put("APR", new Integer (3));
201         monthMap.put("MAY", new Integer (4));
202         monthMap.put("JUN", new Integer (5));
203         monthMap.put("JUL", new Integer (6));
204         monthMap.put("AUG", new Integer (7));
205         monthMap.put("SEP", new Integer (8));
206         monthMap.put("OCT", new Integer (9));
207         monthMap.put("NOV", new Integer (10));
208         monthMap.put("DEC", new Integer (11));
209
210         dayMap.put("SUN", new Integer (1));
211         dayMap.put("MON", new Integer (2));
212         dayMap.put("TUE", new Integer (3));
213         dayMap.put("WED", new Integer (4));
214         dayMap.put("THU", new Integer (5));
215         dayMap.put("FRI", new Integer (6));
216         dayMap.put("SAT", new Integer (7));
217     }
218
219     private Date startTime = null;
220
221     private Date endTime = null;
222
223     private Date nextFireTime = null;
224
225     private TimeZone timeZone = null;
226
227     private Date previousFireTime = null;
228
229     private TreeSet seconds = null;
230
231     private TreeSet minutes = null;
232
233     private TreeSet hours = null;
234
235     private TreeSet daysOfMonth = null;
236
237     private TreeSet months = null;
238
239     private TreeSet daysOfWeek = null;
240
241     private TreeSet years = null;
242
243     private transient boolean lastdayOfWeek = false;
244
245     private transient int nthdayOfWeek = 0;
246
247     private transient boolean lastdayOfMonth = false;
248
249     private transient boolean calendardayOfWeek = false;
250
251     private transient boolean calendardayOfMonth = false;
252
253     /*
254      * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
255      *
256      * Constructors.
257      *
258      * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
259      */
260
261     public void reset() {
262         seconds = new TreeSet ();
263         minutes = new TreeSet ();
264         hours = new TreeSet ();
265         daysOfMonth = new TreeSet ();
266         months = new TreeSet ();
267         daysOfWeek = new TreeSet ();
268         years = new TreeSet ();
269
270         // we always fire on the minute
271 seconds.add(new Integer (0));
272
273         minutes.add(ALL_SPEC);
274         for (int i = 0; i < 60; i++)
275             minutes.add(new Integer (i));
276
277         hours.add(ALL_SPEC);
278         for (int i = 0; i < 24; i++)
279             hours.add(new Integer (i));
280
281         daysOfMonth.add(ALL_SPEC);
282         for (int i = 1; i <= 31; i++)
283             daysOfMonth.add(new Integer (i));
284
285         months.add(ALL_SPEC);
286         for (int i = 1; i <= 12; i++)
287             months.add(new Integer (i));
288
289         daysOfWeek.add(NO_SPEC);
290
291         years.add(ALL_SPEC);
292         for (int i = 1970; i <= 2099; i++)
293             years.add(new Integer (i));
294
295         startTime = new Date ();
296         setStartTime(startTime);
297         setTimeZone(TimeZone.getDefault());
298     }
299
300     /**
301      * <p>
302      * Create a <code>CronTrigger</code> with no settings.
303      * </p>
304      */
305     public UICronTrigger() {
306         super();
307         reset();
308     }
309
310     /**
311      * <p>
312      * Create a <code>CronTrigger</code> with the given name and group.
313      * </p>
314      */
315     public UICronTrigger(String name, String group) {
316         super(name, group);
317         reset();
318     }
319
320     /**
321      * <p>
322      * Create a <code>CronTrigger</code> with the given name and group, and
323      * associated with the identified <code>{@link Job}</code>.
324      * </p>
325      */
326     public UICronTrigger(String name, String group, String jobName,
327             String jobGroup) {
328         super(name, group, jobName, jobGroup);
329         reset();
330     }
331
332     /*
333      * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
334      *
335      * Interface.
336      *
337      * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
338      */
339
340     /**
341      * <p>
342      * Get the time at which the <code>CronTrigger</code> should occur.
343      * </p>
344      */
345     public Date getStartTime() {
346         return this.startTime;
347     }
348
349     public void setStartTime(Date startTime) {
350         if (startTime == null)
351                 throw new IllegalArgumentException ("Start time cannot be null");
352
353         Date eTime = getEndTime();
354         if (eTime != null && startTime != null && eTime.before(startTime))
355             throw new IllegalArgumentException (
356             "End time cannot be before start time");
357
358         
359         // round off millisecond...
360 // Note timeZone is not needed here as parameter for
361 // Calendar.getInstance(), since time zone is implicit
362 // when using a Date in the setTime method.
363 Calendar cl = Calendar.getInstance();
364         cl.setTime(startTime);
365         cl.set(Calendar.MILLISECOND, 0);
366
367         this.startTime = cl.getTime();
368     }
369
370     /**
371      * <p>
372      * Get the time at which the <code>CronTrigger</code> should quit
373      * repeating - even if repeastCount isn't yet satisfied.
374      * </p>
375      *
376      * @see #getFinalFireTime()
377      */
378     public Date getEndTime() {
379         return this.endTime;
380     }
381
382     public void setEndTime(Date endTime) {
383         Date sTime = getStartTime();
384         if (sTime != null && endTime != null && sTime.after(endTime))
385                 throw new IllegalArgumentException (
386                         "End time cannot be before start time");
387
388         this.endTime = endTime;
389     }
390
391     /**
392      * <p>
393      * Returns the next time at which the <code>CronTrigger</code> will fire.
394      * If the trigger will not fire again, <code>null</code> will be
395      * returned. The value returned is not guaranteed to be valid until after
396      * the <code>Trigger</code> has been added to the scheduler.
397      * </p>
398      */
399     public Date getNextFireTime() {
400         return this.nextFireTime;
401     }
402
403     public void updateAfterMisfire(org.quartz.Calendar cal) {
404         int instr = getMisfireInstruction();
405
406         if (instr == MISFIRE_INSTRUCTION_SMART_POLICY)
407                 instr = MISFIRE_INSTRUCTION_DO_NOTHING;
408
409         if (instr == MISFIRE_INSTRUCTION_DO_NOTHING) {
410             Date newFireTime = getFireTimeAfter(new Date ());
411             while (newFireTime != null && cal != null
412                     && !cal.isTimeIncluded(newFireTime.getTime())) {
413                 newFireTime = getFireTimeAfter(newFireTime);
414             }
415
416             setNextFireTime(newFireTime);
417
418         } else if (instr == MISFIRE_INSTRUCTION_FIRE_ONCE_NOW) {
419             setNextFireTime(new Date ());
420         }
421     }
422
423     public Date getPreviousFireTime() {
424         return this.previousFireTime;
425     }
426
427     /**
428      * <p>
429      * Set the previous time at which the <code>SimpleTrigger</code> fired.
430      * </p>
431      *
432      * <p>
433      * <b>This method should not be invoked by client code.</b>
434      * </p>
435      */
436     public void setPreviousFireTime(Date previousFireTime) {
437         this.previousFireTime = previousFireTime;
438     }
439
440     /**
441      * <p>
442      * Sets the next time at which the <code>CronTrigger</code> will fire. If
443      * the trigger will not fire again, <code>null</code> will be returned.
444      * </p>
445      */
446     public void setNextFireTime(Date nextFireTime) {
447         this.nextFireTime = nextFireTime;
448     }
449
450     /**
451      * <p>
452      * Returns the time zone for which the <code>cronExpression</code> of
453      * this <code>CronTrigger</code> will be resolved.
454      * </p>
455      */
456     public TimeZone getTimeZone() {
457         return this.timeZone;
458     }
459
460     /**
461      * <p>
462      * Sets the time zone for which the <code>cronExpression</code> of this
463      * <code>CronTrigger</code> will be resolved.
464      * </p>
465      */
466     public void setTimeZone(TimeZone timeZone) {
467         this.timeZone = timeZone;
468     }
469
470     /**
471      * <p>
472      * Returns the next time at which the <code>CronTrigger</code> will fire,
473      * after the given time. If the trigger will not fire after the given time,
474      * <code>null</code> will be returned.
475      * </p>
476      *
477      * <p>
478      * Note that the date returned is NOT validated against the related
479      * org.quartz.Calendar (if any)
480      * </p>
481      */
482     public Date getFireTimeAfter(Date afterTime) {
483         if (afterTime == null) afterTime = new Date ();
484
485         if (startTime.after(afterTime))
486                 afterTime = new Date (startTime.getTime() - 1000l);
487
488         Date pot = getTimeAfter(afterTime);
489         if (endTime != null && pot != null && pot.after(endTime)) return null;
490
491         return pot;
492     }
493
494     /**
495      * <p>
496      * Returns the final time at which the <code>CronTrigger</code> will
497      * fire.
498      * </p>
499      *
500      * <p>
501      * Note that the return time *may* be in the past. and the date returned is
502      * not validated against org.quartz.calendar
503      * </p>
504      */
505     public Date getFinalFireTime() {
506         if (this.endTime != null) return getTimeBefore(this.endTime);
507         else
508             return null;
509     }
510
511     /**
512      * <p>
513      * Determines whether or not the <code>CronTrigger</code> will occur
514      * again.
515      * </p>
516      */
517     public boolean mayFireAgain() {
518         return (getNextFireTime() != null);
519     }
520
521     protected boolean validateMisfireInstruction(int misfireInstruction) {
522         if (misfireInstruction < MISFIRE_INSTRUCTION_SMART_POLICY)
523                 return false;
524
525         if (misfireInstruction > MISFIRE_INSTRUCTION_DO_NOTHING) return false;
526
527         return true;
528     }
529
530     /**
531      * <p>
532      * Updates the <code>CronTrigger</code>'s state based on the
533      * MISFIRE_INSTRUCTION_XXX that was selected when the <code>SimpleTrigger</code>
534      * was created.
535      * </p>
536      *
537      * <p>
538      * If the misfire instruction is set to MISFIRE_INSTRUCTION_SMART_POLICY,
539      * then the following scheme will be used: <br>
540      * <ul>
541      * <li>The instruction will be interpreted as <code>MISFIRE_INSTRUCTION_DO_NOTHING</code>
542      * </ul>
543      * </p>
544      */
545     public void updateAfterMisfire() {
546         int instr = getMisfireInstruction();
547
548         if (instr == MISFIRE_INSTRUCTION_SMART_POLICY)
549                 instr = MISFIRE_INSTRUCTION_DO_NOTHING;
550
551         if (instr == MISFIRE_INSTRUCTION_DO_NOTHING) {
552             setNextFireTime(getFireTimeAfter(new Date ()));
553         } else if (instr == MISFIRE_INSTRUCTION_FIRE_ONCE_NOW) {
554             setNextFireTime(new Date ());
555         }
556     }
557
558     /**
559      * <p>
560      * Determines whether the date & time of the given java.util.Calendar
561      * instance falls on a scheduled fire-time of this trigger.
562      * </p>
563      *
564      * <p>
565      * Note that the date returned is NOT validated against the related
566      * org.quartz.Calendar (if any)
567      * </p>
568      */
569     public boolean willFireOn(Calendar test) {
570         Integer second = new Integer (test.get(Calendar.SECOND));
571         Integer minute = new Integer (test.get(Calendar.MINUTE));
572         Integer hour = new Integer (test.get(Calendar.HOUR_OF_DAY));
573         Integer day = new Integer (test.get(Calendar.DAY_OF_MONTH));
574         Integer month = new Integer (test.get(Calendar.MONTH));
575
576         if ((seconds.contains(second) || seconds.contains(ALL_SPEC))
577                 && (minutes.contains(minute) || minutes.contains(ALL_SPEC))
578                 && (hours.contains(hour) || hours.contains(ALL_SPEC))
579                 && (daysOfMonth.contains(day) || daysOfMonth.contains(ALL_SPEC))
580                 && (months.contains(month) || months.contains(ALL_SPEC))) {
581
582         return true; }
583
584         return false;
585     }
586
587     /**
588      * <p>
589      * Called after the <code>{@link Scheduler}</code> has executed the
590      * <code>{@link Job}</code> associated with the <code>Trigger</code> in
591      * order to get the final instruction code from the trigger.
592      * </p>
593      *
594      * @param context
595      * is the <code>JobExecutionContext</code> that was used by the
596      * <code>Job</code>'s<code>execute(xx)</code> method.
597      * @param result
598      * is the <code>JobExecutionException</code> thrown by the
599      * <code>Job</code>, if any (may be null).
600      * @return one of the Trigger.INSTRUCTION_XXX constants.
601      *
602      * @see #INSTRUCTION_NOOP
603      * @see #INSTRUCTION_RE_EXECUTE_JOB
604      * @see #INSTRUCTION_DELETE_TRIGGER
605      * @see #INSTRUCTION_SET_TRIGGER_COMPLETE
606      * @see #triggered(Calendar)
607      */
608     public int executionComplete(JobExecutionContext context,
609             JobExecutionException result) {
610         if (result != null && result.refireImmediately())
611                 return Trigger.INSTRUCTION_RE_EXECUTE_JOB;
612
613         if (result != null && result.refireImmediately())
614                 return INSTRUCTION_RE_EXECUTE_JOB;
615
616         if (result != null && result.unscheduleFiringTrigger())
617                 return INSTRUCTION_SET_TRIGGER_COMPLETE;
618
619         if (result != null && result.unscheduleAllTriggers())
620                 return INSTRUCTION_SET_ALL_JOB_TRIGGERS_COMPLETE;
621
622         if (!mayFireAgain()) return INSTRUCTION_DELETE_TRIGGER;
623
624         return INSTRUCTION_NOOP;
625     }
626
627     /**
628      * <p>
629      * Called when the <code>{@link Scheduler}</code> has decided to 'fire'
630      * the trigger (execute the associated <code>Job</code>), in order to
631      * give the <code>Trigger</code> a chance to update itself for its next
632      * triggering (if any).
633      * </p>
634      *
635      * @see #executionComplete(JobExecutionContext, JobExecutionException)
636      */
637     public void triggered(org.quartz.Calendar calendar) {
638         previousFireTime = nextFireTime;
639         nextFireTime = getFireTimeAfter(nextFireTime);
640
641         while (nextFireTime != null && calendar != null
642                 && !calendar.isTimeIncluded(nextFireTime.getTime())) {
643             nextFireTime = getFireTimeAfter(nextFireTime);
644         }
645     }
646
647     /**
648      *
649      * @see org.quartz.Trigger#updateWithNewCalendar(org.quartz.Calendar, long)
650      */
651     public void updateWithNewCalendar(org.quartz.Calendar calendar, long misfireThreshold)
652     {
653         nextFireTime = getFireTimeAfter(previousFireTime);
654         
655         Date now = new Date ();
656         do {
657             while (nextFireTime != null && calendar != null
658                     && !calendar.isTimeIncluded(nextFireTime.getTime())) {
659                 nextFireTime = getFireTimeAfter(nextFireTime);
660             }
661             
662             if(nextFireTime != null && nextFireTime.before(now)) {
663                 long diff = now.getTime() - nextFireTime.getTime();
664                 if(diff >= misfireThreshold) {
665                     nextFireTime = getFireTimeAfter(nextFireTime);
666                     continue;
667                 }
668             }
669         }while(false);
670     }
671
672     /**
673      * <p>
674      * Called by the scheduler at the time a <code>Trigger</code> is first
675      * added to the scheduler, in order to have the <code>Trigger</code>
676      * compute its first fire time, based on any associated calendar.
677      * </p>
678      *
679      * <p>
680      * After this method has been called, <code>getNextFireTime()</code>
681      * should return a valid answer.
682      * </p>
683      *
684      * @return the first time at which the <code>Trigger</code> will be fired
685      * by the scheduler, which is also the same value <code>getNextFireTime()</code>
686      * will return (until after the first firing of the <code>Trigger</code>).
687      * </p>
688      */
689     public Date computeFirstFireTime(org.quartz.Calendar calendar) {
690         nextFireTime = getFireTimeAfter(new Date (startTime.getTime() - 1000l));
691
692         while (nextFireTime != null && calendar != null
693                 && !calendar.isTimeIncluded(nextFireTime.getTime())) {
694             nextFireTime = getFireTimeAfter(nextFireTime);
695         }
696
697         return nextFireTime;
698     }
699
700     public String getExpressionSummary() {
701         StringBuffer buf = new StringBuffer ();
702
703         buf.append("seconds: ");
704         buf.append(getExpressionSetSummary(seconds));
705         buf.append("\n");
706         buf.append("minutes: ");
707         buf.append(getExpressionSetSummary(minutes));
708         buf.append("\n");
709         buf.append("hours: ");
710         buf.append(getExpressionSetSummary(hours));
711         buf.append("\n");
712         buf.append("daysOfMonth: ");
713         buf.append(getExpressionSetSummary(daysOfMonth));
714         buf.append("\n");
715         buf.append("months: ");
716         buf.append(getExpressionSetSummary(months));
717         buf.append("\n");
718         buf.append("daysOfWeek: ");
719         buf.append(getExpressionSetSummary(daysOfWeek));
720         buf.append("\n");
721         buf.append("lastdayOfWeek: ");
722         buf.append(lastdayOfWeek);
723         buf.append("\n");
724         buf.append("lastdayOfMonth: ");
725         buf.append(lastdayOfMonth);
726         buf.append("\n");
727         buf.append("calendardayOfWeek: ");
728         buf.append(calendardayOfWeek);
729         buf.append("\n");
730         buf.append("calendardayOfMonth: ");
731         buf.append(calendardayOfMonth);
732         buf.append("\n");
733         buf.append("years: ");
734         buf.append(getExpressionSetSummary(years));
735         buf.append("\n");
736
737         return buf.toString();
738     }
739
740     private String getExpressionSetSummary(Set set) {
741
742         if (set.contains(NO_SPEC)) return "?";
743         if (set.contains(ALL_SPEC)) return "*";
744
745         StringBuffer buf = new StringBuffer ();
746
747         Iterator itr = set.iterator();
748         boolean first = true;
749         while (itr.hasNext()) {
750             Integer iVal = (Integer ) itr.next();
751             String val = iVal.toString();
752             if (!first) buf.append(",");
753             buf.append(val);
754             first = false;
755         }
756
757         return buf.toString();
758     }
759
760     ////////////////////////////////////////////////////////////////////////////
761 //
762 // Computation Functions
763 //
764 ////////////////////////////////////////////////////////////////////////////
765
766     private Date getTimeAfter(Date afterTime) {
767         Calendar cl = Calendar.getInstance(timeZone);
768
769         // move ahead one second, since we're computing the time *after* the
770 // given time
771 afterTime = new Date (afterTime.getTime() + 1000);
772         // CronTrigger does not deal with milliseconds
773 cl.setTime(afterTime);
774         cl.set(Calendar.MILLISECOND, 0);
775
776         boolean gotOne = false;
777
778         // loop until we've computed the next time, or we've past the endTime
779 while (!gotOne) {
780
781             if (endTime != null && cl.getTime().after(endTime)) return null;
782
783             SortedSet st = null;
784             int t = 0;
785
786             int sec = cl.get(Calendar.SECOND);
787             int min = cl.get(Calendar.MINUTE);
788
789             // get second.................................................
790 st = seconds.tailSet(new Integer (sec));
791             if (st != null && st.size() != 0) {
792                 sec = ((Integer ) st.first()).intValue();
793             } else {
794                 sec = ((Integer ) seconds.first()).intValue();
795                 min++;
796                 cl.set(Calendar.MINUTE, min);
797             }
798             cl.set(Calendar.SECOND, sec);
799
800             min = cl.get(Calendar.MINUTE);
801             int hr = cl.get(Calendar.HOUR_OF_DAY);
802             t = -1;
803
804             // get minute.................................................
805 st = minutes.tailSet(new Integer (min));
806             if (st != null && st.size() != 0) {
807                 t = min;
808                 min = ((Integer ) st.first()).intValue();
809             } else {
810                 min = ((Integer ) minutes.first()).intValue();
811                 hr++;
812             }
813             if (min != t) {
814                 cl.set(Calendar.SECOND, 0);
815                 cl.set(Calendar.MINUTE, min);
816                 cl.set(Calendar.HOUR_OF_DAY, hr);
817                 continue;
818             }
819             cl.set(Calendar.MINUTE, min);
820
821             hr = cl.get(Calendar.HOUR_OF_DAY);
822             int day = cl.get(Calendar.DAY_OF_MONTH);
823             t = -1;
824
825             // get hour...................................................
826 st = hours.tailSet(new Integer (hr));
827             if (st != null && st.size() != 0) {
828                 t = hr;
829                 hr = ((Integer ) st.first()).intValue();
830             } else {
831                 hr = ((Integer ) hours.first()).intValue();
832                 day++;
833             }
834             if (hr != t) {
835                 cl.set(Calendar.SECOND, 0);
836                 cl.set(Calendar.MINUTE, 0);
837                 cl.set(Calendar.HOUR_OF_DAY, hr);
838                 cl.set(Calendar.DAY_OF_MONTH, day);
839                 continue;
840             }
841             cl.set(Calendar.HOUR_OF_DAY, hr);
842
843             day = cl.get(Calendar.DAY_OF_MONTH);
844             int mon = cl.get(Calendar.MONTH) + 1; // '+ 1' because calendar is
845 // 0-based for this field,
846 // and we are 1-based
847 t = -1;
848
849             // get day...................................................
850 boolean dayOfMSpec = !daysOfMonth.contains(NO_SPEC);
851             boolean dayOfWSpec = !daysOfWeek.contains(NO_SPEC);
852             if (dayOfMSpec && !dayOfWSpec) { // get day only by day of month
853 // rule
854 st = daysOfMonth.tailSet(new Integer (day));
855                 if (lastdayOfMonth) {
856                     t = day;
857                     day = getLastDayOfMonth(mon);
858                 } else if (st != null && st.size() != 0) {
859                     t = day;
860                     day = ((Integer ) st.first()).intValue();
861                 } else {
862                     day = ((Integer ) daysOfMonth.first()).intValue();
863                     mon++;
864                 }
865                 if (day != t) {
866                     cl.set(Calendar.SECOND, 0);
867                     cl.set(Calendar.MINUTE, 0);
868                     cl.set(Calendar.HOUR_OF_DAY, 0);
869                     cl.set(Calendar.DAY_OF_MONTH, day);
870                     cl.set(Calendar.MONTH, mon - 1);