org.quartz.triggers.CronTrigger Maven / Gradle / Ivy
Show all versions of sundial Show documentation
/**
* Copyright 2015 Knowm Inc. (http://knowm.org) and contributors.
* Copyright 2013-2015 Xeiam LLC (http://xeiam.com) and contributors.
* Copyright 2001-2011 Terracotta Inc. (http://terracotta.org).
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.quartz.triggers;
import java.util.Calendar;
import java.util.TimeZone;
import org.quartz.core.Scheduler;
/**
* The public interface for inspecting settings specific to a CronTrigger, . which is used to fire a {@link org.quartz.Job} at given
* moments in time, defined with Unix 'cron-like' schedule definitions.
*
* For those unfamiliar with "cron", this means being able to create a firing schedule such as: "At 8:00am every Monday through Friday" or "At 1:30am
* every last Friday of the month".
*
*
* The format of a "Cron-Expression" string is documented on the {@link org.quartz.CronExpression} class.
*
*
* Here are some full examples:
*
*
* Expression
*
* Meaning
*
*
* "0 0 12 * * ?"
* Fire at 12pm (noon) every day
*
* "0 15 10 ? * *"
* Fire at 10:15am every day
*
* "0 15 10 * * ?"
* Fire at 10:15am every day
*
* "0 15 10 * * ? *"
* Fire at 10:15am every day
*
* "0 15 10 * * ? 2005"
* Fire at 10:15am every day during the year 2005
*
* "0 * 14 * * ?"
* Fire every minute starting at 2pm and ending at 2:59pm, every day
*
* "0 0/5 14 * * ?"
* Fire every 5 minutes starting at 2pm and ending at 2:55pm, every day
*
* "0 0/5 14,18 * * ?"
*
* Fire every 5 minutes starting at 2pm and ending at 2:55pm, AND fire every 5 minutes starting at 6pm and ending at 6:55pm, every day
*
*
*
* "0 0-5 14 * * ?"
* Fire every minute starting at 2pm and ending at 2:05pm, every day
*
* "0 10,44 14 ? 3 WED"
* Fire at 2:10pm and at 2:44pm every Wednesday in the month of March.
*
* "0 15 10 ? * MON-FRI"
* Fire at 10:15am every Monday, Tuesday, Wednesday, Thursday and Friday
*
* "0 15 10 15 * ?"
* Fire at 10:15am on the 15th day of every month
*
* "0 15 10 L * ?"
* Fire at 10:15am on the last day of every month
*
* "0 15 10 ? * 6L"
* Fire at 10:15am on the last Friday of every month
*
* "0 15 10 ? * 6L"
* Fire at 10:15am on the last Friday of every month
*
* "0 15 10 ? * 6L 2002-2005"
* Fire at 10:15am on every last Friday of every month during the years 2002, 2003, 2004 and 2005
*
* "0 15 10 ? * 6#3"
* Fire at 10:15am on the third Friday of every month
*
*
*
* Pay attention to the effects of '?' and '*' in the day-of-week and day-of-month fields!
*
*
* NOTES:
*
* - Support for specifying both a day-of-week and a day-of-month value is not complete (you'll need to use the '?' character in on of these
* fields).
* - Be careful when setting fire times between mid-night and 1:00 AM - "daylight savings" can cause a skip or a repeat depending on whether the
* time moves back or jumps forward.
*
*
*
* @author jhouse
* @author Contributions from Mads Henderson
*/
public interface CronTrigger extends Trigger {
public static final long serialVersionUID = -8644953146451592766L;
/**
*
* Instructs the {@link Scheduler} that upon a mis-fire situation, the {@link CronTrigger} wants to be fired now by
* Scheduler.
*
*/
public static final int MISFIRE_INSTRUCTION_FIRE_ONCE_NOW = 1;
/**
*
* Instructs the {@link Scheduler} that upon a mis-fire situation, the {@link CronTrigger} wants to have it's
* next-fire-time updated to the next time in the schedule after the current time (taking into account any associated {@link Calendar},
* but it does not want to be fired now.
*
*/
public static final int MISFIRE_INSTRUCTION_DO_NOTHING = 2;
public String getCronExpression();
/**
*
* Returns the time zone for which the cronExpression of this CronTrigger will be resolved.
*
*/
public TimeZone getTimeZone();
public String getExpressionSummary();
}