com.helger.quartz

Class CronScheduleBuilder

java.lang.Object

com.helger.quartz.CronScheduleBuilder

All Implemented Interfaces:

IScheduleBuilder<CronTrigger>

public class CronScheduleBuilder
extends Object
implements IScheduleBuilder<CronTrigger>

CronScheduleBuilder is a IScheduleBuilder that defines CronExpression-based schedules for Triggers.

Quartz provides a builder-style API for constructing scheduling-related entities via a Domain-Specific Language (DSL). The DSL can best be utilized through the usage of static imports of the methods on the classes TriggerBuilder, JobBuilder, DateBuilder, JobKey, TriggerKey and the various ScheduleBuilder implementations.

Client code can then use the DSL to write code such as this:

 JobDetail job = newJob (MyJob.class).withIdentity ("myJob").build ();
 Trigger trigger = newTrigger ().withIdentity (triggerKey ("myTrigger", "myTriggerGroup"))
                                .withSchedule (dailyAtHourAndMinute (10, 0))
                                .startAt (futureDate (10, MINUTES))
                                .build ();
 scheduler.scheduleJob (job, trigger);
 

See Also:

CronExpression, ICronTrigger, IScheduleBuilder, SimpleScheduleBuilder, CalendarIntervalScheduleBuilder, TriggerBuilder

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CronScheduleBuilder(CronExpression aCronExpression)

Method Summary

Modifier and Type	Method and Description
static CronScheduleBuilder	atHourAndMinuteOnGivenDaysOfWeek(int hour, int minute, DayOfWeek... daysOfWeek) Create a CronScheduleBuilder with a cron-expression that sets the schedule to fire at the given day at the given time (hour and minute) on the given days of the week.
CronTrigger	build() Build the actual Trigger -- NOT intended to be invoked by end users, but will rather be invoked by a TriggerBuilder which this ScheduleBuilder is given to.
static CronScheduleBuilder	cronSchedule(CronExpression cronExpression) Create a CronScheduleBuilder with the given cron-expression.
static CronScheduleBuilder	cronSchedule(String cronExpression) Create a CronScheduleBuilder with the given cron-expression string - which is presumed to b e valid cron expression (and hence only a RuntimeException will be thrown if it is not).
static CronScheduleBuilder	cronScheduleNonvalidatedExpression(String cronExpression) Create a CronScheduleBuilder with the given cron-expression string - which may not be a valid cron expression (and hence a ParseException will be thrown if it is not).
static CronScheduleBuilder	dailyAtHourAndMinute(int hour, int minute) Create a CronScheduleBuilder with a cron-expression that sets the schedule to fire every day at the given time (hour and minute).
CronScheduleBuilder	inTimeZone(TimeZone timezone) The TimeZone in which to base the schedule.
static CronScheduleBuilder	monthlyOnDayAndHourAndMinute(int dayOfMonth, int hour, int minute) Create a CronScheduleBuilder with a cron-expression that sets the schedule to fire one per month on the given day of month at the given time (hour and minute).
static CronScheduleBuilder	weeklyOnDayAndHourAndMinute(DayOfWeek dayOfWeek, int hour, int minute) Create a CronScheduleBuilder with a cron-expression that sets the schedule to fire one per week on the given day at the given time (hour and minute).
CronScheduleBuilder	withMisfireHandlingInstructionDoNothing() If the Trigger misfires, use the ITrigger.EMisfireInstruction.MISFIRE_INSTRUCTION_DO_NOTHING instruction.
CronScheduleBuilder	withMisfireHandlingInstructionFireAndProceed() If the Trigger misfires, use the ITrigger.EMisfireInstruction.MISFIRE_INSTRUCTION_FIRE_ONCE_NOW instruction.
CronScheduleBuilder	withMisfireHandlingInstructionIgnoreMisfires() If the Trigger misfires, use the ITrigger.EMisfireInstruction.MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY instruction.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CronScheduleBuilder

protected CronScheduleBuilder(@Nonnull
                              CronExpression aCronExpression)

Method Detail

build

@Nonnull
public CronTrigger build()

Build the actual Trigger -- NOT intended to be invoked by end users, but will rather be invoked by a TriggerBuilder which this ScheduleBuilder is given to.

Specified by:

build in interface IScheduleBuilder<CronTrigger>

See Also:

TriggerBuilder.withSchedule(IScheduleBuilder)

cronSchedule

@Nonnull
public static CronScheduleBuilder cronSchedule(String cronExpression)

Create a CronScheduleBuilder with the given cron-expression string - which is presumed to b e valid cron expression (and hence only a RuntimeException will be thrown if it is not).

Parameters:

cronExpression - the cron expression string to base the schedule on.

Returns:

the new CronScheduleBuilder

Throws:

RuntimeException - wrapping a ParseException if the expression is invalid

See Also:

CronExpression

cronScheduleNonvalidatedExpression

@Nonnull
public static CronScheduleBuilder cronScheduleNonvalidatedExpression(String cronExpression)
                                                                        throws ParseException

Create a CronScheduleBuilder with the given cron-expression string - which may not be a valid cron expression (and hence a ParseException will be thrown if it is not).

Parameters:

cronExpression - the cron expression string to base the schedule on.

Returns:

the new CronScheduleBuilder

Throws:

ParseException - if the expression is invalid

See Also:

CronExpression

cronSchedule

@Nonnull
public static CronScheduleBuilder cronSchedule(CronExpression cronExpression)

Create a CronScheduleBuilder with the given cron-expression.

Parameters:

cronExpression - the cron expression to base the schedule on.

Returns:

the new CronScheduleBuilder

See Also:

CronExpression

dailyAtHourAndMinute

@Nonnull
public static CronScheduleBuilder dailyAtHourAndMinute(int hour,
                                                                 int minute)

Create a CronScheduleBuilder with a cron-expression that sets the schedule to fire every day at the given time (hour and minute).

Parameters:

hour - the hour of day to fire

minute - the minute of the given hour to fire

Returns:

the new CronScheduleBuilder

See Also:

CronExpression

atHourAndMinuteOnGivenDaysOfWeek

@Nonnull
public static CronScheduleBuilder atHourAndMinuteOnGivenDaysOfWeek(int hour,
                                                                             int minute,
                                                                             DayOfWeek... daysOfWeek)

Create a CronScheduleBuilder with a cron-expression that sets the schedule to fire at the given day at the given time (hour and minute) on the given days of the week.

Parameters:

daysOfWeek - the dasy of the week to fire

hour - the hour of day to fire

minute - the minute of the given hour to fire

Returns:

the new CronScheduleBuilder

See Also:

CronExpression

weeklyOnDayAndHourAndMinute

@Nonnull
public static CronScheduleBuilder weeklyOnDayAndHourAndMinute(DayOfWeek dayOfWeek,
                                                                        int hour,
                                                                        int minute)

Create a CronScheduleBuilder with a cron-expression that sets the schedule to fire one per week on the given day at the given time (hour and minute).

Parameters:

dayOfWeek - the day of the week to fire

hour - the hour of day to fire

minute - the minute of the given hour to fire

Returns:

the new CronScheduleBuilder

See Also:

CronExpression

monthlyOnDayAndHourAndMinute

@Nonnull
public static CronScheduleBuilder monthlyOnDayAndHourAndMinute(int dayOfMonth,
                                                                         int hour,
                                                                         int minute)

Create a CronScheduleBuilder with a cron-expression that sets the schedule to fire one per month on the given day of month at the given time (hour and minute).

Parameters:

dayOfMonth - the day of the month to fire

hour - the hour of day to fire

minute - the minute of the given hour to fire

Returns:

the new CronScheduleBuilder

See Also:

CronExpression

inTimeZone

@Nonnull
public CronScheduleBuilder inTimeZone(TimeZone timezone)

The TimeZone in which to base the schedule.

Parameters:

timezone - the time-zone for the schedule.

Returns:

the updated CronScheduleBuilder

See Also:

CronExpression.getTimeZone()

withMisfireHandlingInstructionIgnoreMisfires

@Nonnull
public CronScheduleBuilder withMisfireHandlingInstructionIgnoreMisfires()

If the Trigger misfires, use the ITrigger.EMisfireInstruction.MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY instruction.

Returns:

the updated CronScheduleBuilder

See Also:

ITrigger.EMisfireInstruction.MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY

withMisfireHandlingInstructionDoNothing

@Nonnull
public CronScheduleBuilder withMisfireHandlingInstructionDoNothing()

If the Trigger misfires, use the ITrigger.EMisfireInstruction.MISFIRE_INSTRUCTION_DO_NOTHING instruction.

Returns:

the updated CronScheduleBuilder

See Also:

ITrigger.EMisfireInstruction.MISFIRE_INSTRUCTION_DO_NOTHING

withMisfireHandlingInstructionFireAndProceed

@Nonnull
public CronScheduleBuilder withMisfireHandlingInstructionFireAndProceed()

If the Trigger misfires, use the ITrigger.EMisfireInstruction.MISFIRE_INSTRUCTION_FIRE_ONCE_NOW instruction.

Returns:

the updated CronScheduleBuilder

See Also:

ITrigger.EMisfireInstruction.MISFIRE_INSTRUCTION_FIRE_ONCE_NOW