Clarified that CronTrigger never schedules overlapping executions

jhoeller · jhoeller · commit 5dbbd8fe72bd · 2013-05-14T21:16:04.000+02:00
Issue: SPR-10556
diff --git a/spring-context/src/main/java/org/springframework/scheduling/support/CronTrigger.java b/spring-context/src/main/java/org/springframework/scheduling/support/CronTrigger.java
@@ -16,12 +16,12 @@
 
 package org.springframework.scheduling.support;
 
-import org.springframework.scheduling.Trigger;
-import org.springframework.scheduling.TriggerContext;
-
 import java.util.Date;
 import java.util.TimeZone;
 
+import org.springframework.scheduling.Trigger;
+import org.springframework.scheduling.TriggerContext;
+
 /**
  * {@link Trigger} implementation for cron expressions.
  * Wraps a {@link CronSequenceGenerator}.
@@ -55,6 +55,12 @@ public CronTrigger(String cronExpression, TimeZone timeZone) {
 	}
 
 
+	/**
+	 * Determine the next execution time according to the given trigger context.
+	 * <p>Next execution times are calculated based on the
+	 * {@linkplain TriggerContext#lastCompletionTime completion time} of the
+	 * previous execution; therefore, overlapping executions won't occur.
+	 */
 	@Override
 	public Date nextExecutionTime(TriggerContext triggerContext) {
 		Date date = triggerContext.lastCompletionTime();
