io.logspace.agent.shaded.quartz.CronTrigger Maven / Gradle / Ivy
/*
* All content copyright Terracotta, Inc., unless otherwise indicated. All rights reserved.
*
* 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 io.logspace.agent.shaded.quartz;
import java.util.Calendar;
import java.util.TimeZone;
/**
* The public interface for inspecting settings specific to a CronTrigger, .
* which is used to fire a {@link io.logspace.agent.shaded.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 io.logspace.agent.shaded.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.
*
*
*
* @see CronScheduleBuilder
* @see TriggerBuilder
*
* @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();
TriggerBuilder getTriggerBuilder();
}