org.quartz.impl.jdbcjobstore

Class StdJDBCDelegate

java.lang.Object

org.quartz.impl.jdbcjobstore.StdJDBCDelegate

All Implemented Interfaces:

Constants, StdJDBCConstants

Direct Known Subclasses:

CloudscapeDelegate, DB2v6Delegate, DB2v7Delegate, DB2v8Delegate, HSQLDBDelegate, MSSQLDelegate, PointbaseDelegate, PostgreSQLDelegate

public class StdJDBCDelegate
extends java.lang.Object
implements StdJDBCConstants

This is meant to be an abstract base class for most, if not all, DriverDelegate implementations. Subclasses should override only those methods that need special handling for the DBMS driver in question.

Author:

Jeffrey Wescott, James House, Eric Mueller

Field Summary

Fields inherited from interface org.quartz.impl.jdbcjobstore.StdJDBCConstants

COUNT_MISFIRED_TRIGGERS_IN_STATES, DELETE_BLOB_TRIGGER, DELETE_CALENDAR, DELETE_CRON_TRIGGER, DELETE_FIRED_TRIGGER, DELETE_FIRED_TRIGGERS, DELETE_INSTANCES_FIRED_TRIGGERS, DELETE_JOB_DETAIL, DELETE_JOB_LISTENERS, DELETE_NO_RECOVERY_FIRED_TRIGGERS, DELETE_PAUSED_TRIGGER_GROUP, DELETE_PAUSED_TRIGGER_GROUPS, DELETE_SCHEDULER_STATE, DELETE_SIMPLE_TRIGGER, DELETE_TRIGGER, DELETE_TRIGGER_LISTENERS, DELETE_VOLATILE_FIRED_TRIGGERS, INSERT_BLOB_TRIGGER, INSERT_CALENDAR, INSERT_CRON_TRIGGER, INSERT_FIRED_TRIGGER, INSERT_JOB_DETAIL, INSERT_JOB_LISTENER, INSERT_PAUSED_TRIGGER_GROUP, INSERT_SCHEDULER_STATE, INSERT_SIMPLE_TRIGGER, INSERT_TRIGGER, INSERT_TRIGGER_LISTENER, SELECT_BLOB_TRIGGER, SELECT_CALENDAR, SELECT_CALENDAR_EXISTENCE, SELECT_CALENDARS, SELECT_CRON_TRIGGER, SELECT_FIRED_TRIGGER, SELECT_FIRED_TRIGGER_GROUP, SELECT_FIRED_TRIGGER_INSTANCE_NAMES, SELECT_FIRED_TRIGGERS, SELECT_FIRED_TRIGGERS_OF_JOB, SELECT_FIRED_TRIGGERS_OF_JOB_GROUP, SELECT_INSTANCES_FIRED_TRIGGERS, SELECT_INSTANCES_RECOVERABLE_FIRED_TRIGGERS, SELECT_JOB_DETAIL, SELECT_JOB_EXECUTION_COUNT, SELECT_JOB_EXISTENCE, SELECT_JOB_FOR_TRIGGER, SELECT_JOB_GROUPS, SELECT_JOB_LISTENERS, SELECT_JOB_STATEFUL, SELECT_JOBS_IN_GROUP, SELECT_MISFIRED_TRIGGERS, SELECT_MISFIRED_TRIGGERS_IN_GROUP_IN_STATE, SELECT_MISFIRED_TRIGGERS_IN_STATE, SELECT_MISFIRED_TRIGGERS_IN_STATES, SELECT_NEXT_FIRE_TIME, SELECT_NEXT_TRIGGER_TO_ACQUIRE, SELECT_NUM_CALENDARS, SELECT_NUM_JOBS, SELECT_NUM_TRIGGERS, SELECT_NUM_TRIGGERS_FOR_JOB, SELECT_NUM_TRIGGERS_IN_GROUP, SELECT_PAUSED_TRIGGER_GROUP, SELECT_PAUSED_TRIGGER_GROUPS, SELECT_REFERENCED_CALENDAR, SELECT_SCHEDULER_STATE, SELECT_SCHEDULER_STATES, SELECT_SIMPLE_TRIGGER, SELECT_STATEFUL_JOBS_OF_TRIGGER_GROUP, SELECT_TRIGGER, SELECT_TRIGGER_DATA, SELECT_TRIGGER_EXISTENCE, SELECT_TRIGGER_FOR_FIRE_TIME, SELECT_TRIGGER_GROUPS, SELECT_TRIGGER_LISTENERS, SELECT_TRIGGER_STATE, SELECT_TRIGGER_STATUS, SELECT_TRIGGERS_FOR_CALENDAR, SELECT_TRIGGERS_FOR_JOB, SELECT_TRIGGERS_IN_GROUP, SELECT_TRIGGERS_IN_STATE, SELECT_VOLATILE_JOBS, SELECT_VOLATILE_TRIGGERS, TABLE_PREFIX_SUBST, UPDATE_BLOB_TRIGGER, UPDATE_CALENDAR, UPDATE_CRON_TRIGGER, UPDATE_INSTANCES_FIRED_TRIGGER_STATE, UPDATE_JOB_DATA, UPDATE_JOB_DETAIL, UPDATE_JOB_TRIGGER_STATES, UPDATE_JOB_TRIGGER_STATES_FROM_OTHER_STATE, UPDATE_SCHEDULER_STATE, UPDATE_SIMPLE_TRIGGER, UPDATE_TRIGGER, UPDATE_TRIGGER_GROUP_STATE, UPDATE_TRIGGER_GROUP_STATE_FROM_STATE, UPDATE_TRIGGER_GROUP_STATE_FROM_STATES, UPDATE_TRIGGER_SKIP_DATA, UPDATE_TRIGGER_STATE, UPDATE_TRIGGER_STATE_FROM_OTHER_STATES_BEFORE_TIME, UPDATE_TRIGGER_STATE_FROM_STATE, UPDATE_TRIGGER_STATE_FROM_STATES, UPDATE_TRIGGER_STATES_FROM_OTHER_STATES

Fields inherited from interface org.quartz.impl.jdbcjobstore.Constants

ALIAS_COL_NEXT_FIRE_TIME, ALL_GROUPS_PAUSED, COL_BLOB, COL_CALENDAR, COL_CALENDAR_NAME, COL_CHECKIN_INTERVAL, COL_CRON_EXPRESSION, COL_DESCRIPTION, COL_END_TIME, COL_ENTRY_ID, COL_ENTRY_STATE, COL_FIRED_TIME, COL_INSTANCE_NAME, COL_IS_DURABLE, COL_IS_STATEFUL, COL_IS_VOLATILE, COL_JOB_CLASS, COL_JOB_DATAMAP, COL_JOB_GROUP, COL_JOB_LISTENER, COL_JOB_NAME, COL_LAST_CHECKIN_TIME, COL_LOCK_NAME, COL_MISFIRE_INSTRUCTION, COL_NEXT_FIRE_TIME, COL_PREV_FIRE_TIME, COL_PRIORITY, COL_REPEAT_COUNT, COL_REPEAT_INTERVAL, COL_REQUESTS_RECOVERY, COL_START_TIME, COL_TIME_ZONE_ID, COL_TIMES_TRIGGERED, COL_TRIGGER_GROUP, COL_TRIGGER_LISTENER, COL_TRIGGER_NAME, COL_TRIGGER_STATE, COL_TRIGGER_TYPE, DEFAULT_TABLE_PREFIX, STATE_ACQUIRED, STATE_BLOCKED, STATE_COMPLETE, STATE_DELETED, STATE_ERROR, STATE_EXECUTING, STATE_MISFIRED, STATE_PAUSED, STATE_PAUSED_BLOCKED, STATE_WAITING, TABLE_BLOB_TRIGGERS, TABLE_CALENDARS, TABLE_CRON_TRIGGERS, TABLE_FIRED_TRIGGERS, TABLE_JOB_DETAILS, TABLE_JOB_LISTENERS, TABLE_LOCKS, TABLE_PAUSED_TRIGGERS, TABLE_SCHEDULER_STATE, TABLE_SIMPLE_TRIGGERS, TABLE_TRIGGER_LISTENERS, TABLE_TRIGGERS, TTYPE_BLOB, TTYPE_CRON, TTYPE_SIMPLE

Constructor Summary

Constructors

Constructor and Description
StdJDBCDelegate(org.apache.commons.logging.Log logger, java.lang.String tablePrefix, java.lang.String instanceId) Create new StdJDBCDelegate instance.
StdJDBCDelegate(org.apache.commons.logging.Log logger, java.lang.String tablePrefix, java.lang.String instanceId, java.lang.Boolean useProperties) Create new StdJDBCDelegate instance.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	calendarExists(java.sql.Connection conn, java.lang.String calendarName) Check whether or not a calendar exists.
boolean	calendarIsReferenced(java.sql.Connection conn, java.lang.String calendarName) Check whether or not a calendar is referenced by any triggers.
int	countMisfiredTriggersInStates(java.sql.Connection conn, java.lang.String state1, java.lang.String state2, long ts) Get the number of triggers in the given states that have misfired - according to the given timestamp.
int	deleteAllPausedTriggerGroups(java.sql.Connection conn)
int	deleteBlobTrigger(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Delete the cron trigger data for a trigger.
int	deleteCalendar(java.sql.Connection conn, java.lang.String calendarName) Delete a calendar.
int	deleteCronTrigger(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Delete the cron trigger data for a trigger.
int	deleteFiredTrigger(java.sql.Connection conn, java.lang.String entryId) Delete a fired trigger.
int	deleteFiredTriggers(java.sql.Connection conn) Delete all fired triggers.
int	deleteFiredTriggers(java.sql.Connection conn, java.lang.String instanceId) Delete all fired triggers of the given instance.
int	deleteJobDetail(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName) Delete the job detail record for the given job.
int	deleteJobListeners(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName) Delete all job listeners for the given job.
int	deletePausedTriggerGroup(java.sql.Connection conn, java.lang.String groupName)
int	deleteSchedulerState(java.sql.Connection conn, java.lang.String instanceId) Delete a scheduler-instance state record.
int	deleteSimpleTrigger(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Delete the simple trigger data for a trigger.
int	deleteTrigger(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Delete the base trigger data for a trigger.
int	deleteTriggerListeners(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Delete all of the listeners associated with a given trigger.
int	deleteVolatileFiredTriggers(java.sql.Connection conn) Delete all volatile fired triggers.
int	insertBlobTrigger(java.sql.Connection conn, Trigger trigger) Insert the blob trigger data.
int	insertCalendar(java.sql.Connection conn, java.lang.String calendarName, Calendar calendar) Insert a new calendar.
int	insertCronTrigger(java.sql.Connection conn, CronTrigger trigger) Insert the cron trigger data.
int	insertFiredTrigger(java.sql.Connection conn, Trigger trigger, java.lang.String state, JobDetail job) Insert a fired trigger.
int	insertJobDetail(java.sql.Connection conn, JobDetail job) Insert the job detail record.
int	insertJobListener(java.sql.Connection conn, JobDetail job, java.lang.String listener) Associate a listener with a job.
int	insertPausedTriggerGroup(java.sql.Connection conn, java.lang.String groupName)
int	insertSchedulerState(java.sql.Connection conn, java.lang.String instanceId, long checkInTime, long interval) Insert a scheduler-instance state record.
int	insertSimpleTrigger(java.sql.Connection conn, SimpleTrigger trigger) Insert the simple trigger data.
int	insertTrigger(java.sql.Connection conn, Trigger trigger, java.lang.String state, JobDetail jobDetail) Insert the base trigger data.
int	insertTriggerListener(java.sql.Connection conn, Trigger trigger, java.lang.String listener) Associate a listener with the given trigger.
boolean	isExistingTriggerGroup(java.sql.Connection conn, java.lang.String groupName)
boolean	isJobStateful(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName) Check whether or not the given job is stateful.
boolean	isTriggerGroupPaused(java.sql.Connection conn, java.lang.String groupName)
boolean	jobExists(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName) Check whether or not the given job exists.
Calendar	selectCalendar(java.sql.Connection conn, java.lang.String calendarName) Select a calendar.
java.lang.String[]	selectCalendars(java.sql.Connection conn) Select all of the stored calendars.
java.util.Set	selectFiredTriggerInstanceNames(java.sql.Connection conn) Select the distinct instance names of all fired-trigger records.
java.util.List	selectFiredTriggerRecords(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Select the states of all fired-trigger records for a given trigger, or trigger group if trigger name is null.
java.util.List	selectFiredTriggerRecordsByJob(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName) Select the states of all fired-trigger records for a given job, or job group if job name is null.
java.util.List	selectInstancesFiredTriggerRecords(java.sql.Connection conn, java.lang.String instanceName) Select the states of all fired-trigger records for a given scheduler instance.
JobDetail	selectJobDetail(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName, ClassLoadHelper loadHelper) Select the JobDetail object for a given job name / group name.
int	selectJobExecutionCount(java.sql.Connection conn, java.lang.String jobName, java.lang.String jobGroup) Get the number instances of the identified job currently executing.
JobDetail	selectJobForTrigger(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName, ClassLoadHelper loadHelper) Select the job to which the trigger is associated.
java.lang.String[]	selectJobGroups(java.sql.Connection conn) Select all of the job group names that are stored.
java.lang.String[]	selectJobListeners(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName) Get all of the listeners for a given job.
java.lang.String[]	selectJobsInGroup(java.sql.Connection conn, java.lang.String groupName) Select all of the jobs contained in a given group.
Key[]	selectMisfiredTriggers(java.sql.Connection conn, long ts) Get the names of all of the triggers that have misfired.
Key[]	selectMisfiredTriggersInGroupInState(java.sql.Connection conn, java.lang.String groupName, java.lang.String state, long ts) Get the names of all of the triggers in the given group and state that have misfired.
Key[]	selectMisfiredTriggersInState(java.sql.Connection conn, java.lang.String state, long ts) Get the names of all of the triggers in the given state that have misfired - according to the given timestamp.
boolean	selectMisfiredTriggersInStates(java.sql.Connection conn, java.lang.String state1, java.lang.String state2, long ts, int count, java.util.List resultList) Get the names of all of the triggers in the given states that have misfired - according to the given timestamp.
long	selectNextFireTime(java.sql.Connection conn) Deprecated. Does not account for misfires.
int	selectNumCalendars(java.sql.Connection conn) Select the total number of calendars stored.
int	selectNumJobs(java.sql.Connection conn) Select the total number of jobs stored.
int	selectNumTriggers(java.sql.Connection conn) Select the total number of triggers stored.
int	selectNumTriggersForJob(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName) Select the number of triggers associated with a given job.
java.util.Set	selectPausedTriggerGroups(java.sql.Connection conn)
java.util.List	selectSchedulerStateRecords(java.sql.Connection conn, java.lang.String instanceId) A List of all current SchedulerStateRecords.
java.util.List	selectStatefulJobsOfTriggerGroup(java.sql.Connection conn, java.lang.String groupName) Select the stateful jobs which are referenced by triggers in the given trigger group.
Trigger	selectTrigger(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Select a trigger.
Key	selectTriggerForFireTime(java.sql.Connection conn, long fireTime) Select the trigger that will be fired at the given fire time.
java.lang.String[]	selectTriggerGroups(java.sql.Connection conn) Select all of the trigger group names that are stored.
JobDataMap	selectTriggerJobDataMap(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Select a trigger's JobDataMap.
java.lang.String[]	selectTriggerListeners(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Select the listeners associated with a given trigger.
Key[]	selectTriggerNamesForJob(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName) Get the names of all of the triggers associated with the given job.
Trigger[]	selectTriggersForCalendar(java.sql.Connection conn, java.lang.String calName) Select the triggers for a calendar
Trigger[]	selectTriggersForJob(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName) Select the triggers for a job
Trigger[]	selectTriggersForRecoveringJobs(java.sql.Connection conn) Select all of the triggers for jobs that are requesting recovery.
java.lang.String[]	selectTriggersInGroup(java.sql.Connection conn, java.lang.String groupName) Select all of the triggers contained in a given group.
Key[]	selectTriggersInState(java.sql.Connection conn, java.lang.String state) Select all of the triggers in a given state.
java.lang.String	selectTriggerState(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Select a trigger' state value.
TriggerStatus	selectTriggerStatus(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Select a trigger' status (state & next fire time).
java.util.List	selectTriggerToAcquire(java.sql.Connection conn, long noLaterThan, long noEarlierThan) Select the next trigger which will fire to fire between the two given timestamps in ascending order of fire time, and then descending by priority.
Key[]	selectVolatileJobs(java.sql.Connection conn) Get the names of all of the jobs that are volatile.
Key[]	selectVolatileTriggers(java.sql.Connection conn) Get the names of all of the triggers that are volatile.
boolean	triggerExists(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName) Check whether or not a trigger exists.
int	updateBlobTrigger(java.sql.Connection conn, Trigger trigger) Update the blob trigger data.
int	updateCalendar(java.sql.Connection conn, java.lang.String calendarName, Calendar calendar) Update a calendar.
int	updateCronTrigger(java.sql.Connection conn, CronTrigger trigger) Update the cron trigger data.
int	updateJobData(java.sql.Connection conn, JobDetail job) Update the job data map for the given job.
int	updateJobDetail(java.sql.Connection conn, JobDetail job) Update the job detail record.
int	updateSchedulerState(java.sql.Connection conn, java.lang.String instanceId, long checkInTime) Update a scheduler-instance state record.
int	updateSimpleTrigger(java.sql.Connection conn, SimpleTrigger trigger) Update the simple trigger data.
int	updateTrigger(java.sql.Connection conn, Trigger trigger, java.lang.String state, JobDetail jobDetail) Update the base trigger data.
int	updateTriggerGroupStateFromOtherState(java.sql.Connection conn, java.lang.String groupName, java.lang.String newState, java.lang.String oldState) Update all of the triggers of the given group to the given new state, if they are in the given old state.
int	updateTriggerGroupStateFromOtherStates(java.sql.Connection conn, java.lang.String groupName, java.lang.String newState, java.lang.String oldState1, java.lang.String oldState2, java.lang.String oldState3) Update all triggers in the given group to the given new state, if they are in one of the given old states.
int	updateTriggerState(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName, java.lang.String state) Update the state for a given trigger.
int	updateTriggerStateFromOtherState(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName, java.lang.String newState, java.lang.String oldState) Update the given trigger to the given new state, if it is in the given old state.
int	updateTriggerStateFromOtherStates(java.sql.Connection conn, java.lang.String triggerName, java.lang.String groupName, java.lang.String newState, java.lang.String oldState1, java.lang.String oldState2, java.lang.String oldState3) Update the given trigger to the given new state, if it is one of the given old states.
int	updateTriggerStateFromOtherStatesBeforeTime(java.sql.Connection conn, java.lang.String newState, java.lang.String oldState1, java.lang.String oldState2, long time) Update the all triggers to the given new state, if they are in one of the given old states AND its next fire time is before the given time.
int	updateTriggerStatesForJob(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName, java.lang.String state) Update the states of all triggers associated with the given job.
int	updateTriggerStatesForJobFromOtherState(java.sql.Connection conn, java.lang.String jobName, java.lang.String groupName, java.lang.String state, java.lang.String oldState) Update the states of any triggers associated with the given job, that are the given current state.
int	updateTriggerStatesFromOtherStates(java.sql.Connection conn, java.lang.String newState, java.lang.String oldState1, java.lang.String oldState2) Insert the job detail record.

Methods inherited from class java.lang.Object

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

Constructor Detail

StdJDBCDelegate

public StdJDBCDelegate(org.apache.commons.logging.Log logger,
               java.lang.String tablePrefix,
               java.lang.String instanceId)

Create new StdJDBCDelegate instance.

Parameters:

logger - the logger to use during execution

tablePrefix - the prefix of all table names

StdJDBCDelegate

public StdJDBCDelegate(org.apache.commons.logging.Log logger,
               java.lang.String tablePrefix,
               java.lang.String instanceId,
               java.lang.Boolean useProperties)

Create new StdJDBCDelegate instance.

Parameters:

logger - the logger to use during execution

tablePrefix - the prefix of all table names

Method Detail

updateTriggerStatesFromOtherStates

public int updateTriggerStatesFromOtherStates(java.sql.Connection conn,
                                     java.lang.String newState,
                                     java.lang.String oldState1,
                                     java.lang.String oldState2)
                                       throws java.sql.SQLException

Insert the job detail record.

Parameters:

conn - the DB Connection

newState - the new state for the triggers

oldState1 - the first old state to update

oldState2 - the second old state to update

Returns:

number of rows updated

Throws:

java.sql.SQLException

selectMisfiredTriggers

public Key[] selectMisfiredTriggers(java.sql.Connection conn,
                           long ts)
                             throws java.sql.SQLException

Get the names of all of the triggers that have misfired.

Parameters:

conn - the DB Connection

Returns:

an array of Key objects

Throws:

java.sql.SQLException

selectTriggersInState

public Key[] selectTriggersInState(java.sql.Connection conn,
                          java.lang.String state)
                            throws java.sql.SQLException

Select all of the triggers in a given state.

Parameters:

conn - the DB Connection

state - the state the triggers must be in

Returns:

an array of trigger Key s

Throws:

java.sql.SQLException

selectMisfiredTriggersInState

public Key[] selectMisfiredTriggersInState(java.sql.Connection conn,
                                  java.lang.String state,
                                  long ts)
                                    throws java.sql.SQLException

Get the names of all of the triggers in the given state that have misfired - according to the given timestamp.

Parameters:

conn - the DB Connection

Returns:

an array of Key objects

Throws:

java.sql.SQLException

selectMisfiredTriggersInStates

public boolean selectMisfiredTriggersInStates(java.sql.Connection conn,
                                     java.lang.String state1,
                                     java.lang.String state2,
                                     long ts,
                                     int count,
                                     java.util.List resultList)
                                       throws java.sql.SQLException

Get the names of all of the triggers in the given states that have misfired - according to the given timestamp. No more than count will be returned.

Parameters:

conn - The DB Connection

count - The most misfired triggers to return, negative for all

resultList - Output parameter. A List of Key objects. Must not be null.

Returns:

Whether there are more misfired triggers left to find beyond the given count.

Throws:

java.sql.SQLException

countMisfiredTriggersInStates

public int countMisfiredTriggersInStates(java.sql.Connection conn,
                                java.lang.String state1,
                                java.lang.String state2,
                                long ts)
                                  throws java.sql.SQLException

Get the number of triggers in the given states that have misfired - according to the given timestamp.

Parameters:

conn - the DB Connection

Throws:

java.sql.SQLException

selectMisfiredTriggersInGroupInState

public Key[] selectMisfiredTriggersInGroupInState(java.sql.Connection conn,
                                         java.lang.String groupName,
                                         java.lang.String state,
                                         long ts)
                                           throws java.sql.SQLException

Get the names of all of the triggers in the given group and state that have misfired.

Parameters:

conn - the DB Connection

Returns:

an array of Key objects

Throws:

java.sql.SQLException

selectTriggersForRecoveringJobs

public Trigger[] selectTriggersForRecoveringJobs(java.sql.Connection conn)
                                          throws java.sql.SQLException,
                                                 java.io.IOException,
                                                 java.lang.ClassNotFoundException

Select all of the triggers for jobs that are requesting recovery. The returned trigger objects will have unique "recoverXXX" trigger names and will be in the Scheduler.DEFAULT_RECOVERY_GROUP trigger group.

In order to preserve the ordering of the triggers, the fire time will be set from the COL_FIRED_TIME column in the TABLE_FIRED_TRIGGERS table. The caller is responsible for calling computeFirstFireTime on each returned trigger. It is also up to the caller to insert the returned triggers to ensure that they are fired.

Parameters:

conn - the DB Connection

Returns:

an array of Trigger objects

Throws:

java.sql.SQLException

java.io.IOException

java.lang.ClassNotFoundException

deleteFiredTriggers

public int deleteFiredTriggers(java.sql.Connection conn)
                        throws java.sql.SQLException

Delete all fired triggers.

Parameters:

conn - the DB Connection

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

deleteFiredTriggers

public int deleteFiredTriggers(java.sql.Connection conn,
                      java.lang.String instanceId)
                        throws java.sql.SQLException

Delete all fired triggers of the given instance.

Parameters:

conn - the DB Connection

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

insertJobDetail

public int insertJobDetail(java.sql.Connection conn,
                  JobDetail job)
                    throws java.io.IOException,
                           java.sql.SQLException

Insert the job detail record.

Parameters:

conn - the DB Connection

job - the job to insert

Returns:

number of rows inserted

Throws:

java.io.IOException - if there were problems serializing the JobDataMap

java.sql.SQLException

updateJobDetail

public int updateJobDetail(java.sql.Connection conn,
                  JobDetail job)
                    throws java.io.IOException,
                           java.sql.SQLException

Update the job detail record.

Parameters:

conn - the DB Connection

job - the job to update

Returns:

number of rows updated

Throws:

java.io.IOException - if there were problems serializing the JobDataMap

java.sql.SQLException

selectTriggerNamesForJob

public Key[] selectTriggerNamesForJob(java.sql.Connection conn,
                             java.lang.String jobName,
                             java.lang.String groupName)
                               throws java.sql.SQLException

Get the names of all of the triggers associated with the given job.

Parameters:

conn - the DB Connection

jobName - the name of the job

groupName - the group containing the job

Returns:

an array of Key objects

Throws:

java.sql.SQLException

deleteJobListeners

public int deleteJobListeners(java.sql.Connection conn,
                     java.lang.String jobName,
                     java.lang.String groupName)
                       throws java.sql.SQLException

Delete all job listeners for the given job.

Parameters:

conn - the DB Connection

jobName - the name of the job

groupName - the group containing the job

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

deleteJobDetail

public int deleteJobDetail(java.sql.Connection conn,
                  java.lang.String jobName,
                  java.lang.String groupName)
                    throws java.sql.SQLException

Delete the job detail record for the given job.

Parameters:

conn - the DB Connection

jobName - the name of the job

groupName - the group containing the job

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

isJobStateful

public boolean isJobStateful(java.sql.Connection conn,
                    java.lang.String jobName,
                    java.lang.String groupName)
                      throws java.sql.SQLException

Check whether or not the given job is stateful.

Parameters:

conn - the DB Connection

jobName - the name of the job

groupName - the group containing the job

Returns:

true if the job exists and is stateful, false otherwise

Throws:

java.sql.SQLException

jobExists

public boolean jobExists(java.sql.Connection conn,
                java.lang.String jobName,
                java.lang.String groupName)
                  throws java.sql.SQLException

Check whether or not the given job exists.

Parameters:

conn - the DB Connection

jobName - the name of the job

groupName - the group containing the job

Returns:

true if the job exists, false otherwise

Throws:

java.sql.SQLException

updateJobData

public int updateJobData(java.sql.Connection conn,
                JobDetail job)
                  throws java.io.IOException,
                         java.sql.SQLException

Update the job data map for the given job.

Parameters:

conn - the DB Connection

job - the job to update

Returns:

the number of rows updated

Throws:

java.io.IOException - if there were problems serializing the JobDataMap

java.sql.SQLException

insertJobListener

public int insertJobListener(java.sql.Connection conn,
                    JobDetail job,
                    java.lang.String listener)
                      throws java.sql.SQLException

Associate a listener with a job.

Parameters:

conn - the DB Connection

job - the job to associate with the listener

listener - the listener to insert

Returns:

the number of rows inserted

Throws:

java.sql.SQLException

selectJobListeners

public java.lang.String[] selectJobListeners(java.sql.Connection conn,
                                    java.lang.String jobName,
                                    java.lang.String groupName)
                                      throws java.sql.SQLException

Get all of the listeners for a given job.

Parameters:

conn - the DB Connection

jobName - the job name whose listeners are wanted

groupName - the group containing the job

Returns:

array of String listener names

Throws:

java.sql.SQLException

selectJobDetail

public JobDetail selectJobDetail(java.sql.Connection conn,
                        java.lang.String jobName,
                        java.lang.String groupName,
                        ClassLoadHelper loadHelper)
                          throws java.lang.ClassNotFoundException,
                                 java.io.IOException,
                                 java.sql.SQLException

Select the JobDetail object for a given job name / group name.

Parameters:

conn - the DB Connection

jobName - the job name whose listeners are wanted

groupName - the group containing the job

Returns:

the populated JobDetail object

Throws:

java.lang.ClassNotFoundException - if a class found during deserialization cannot be found or if the job class could not be found

java.io.IOException - if deserialization causes an error

java.sql.SQLException

selectNumJobs

public int selectNumJobs(java.sql.Connection conn)
                  throws java.sql.SQLException

Select the total number of jobs stored.

Parameters:

conn - the DB Connection

Returns:

the total number of jobs stored

Throws:

java.sql.SQLException

selectJobGroups

public java.lang.String[] selectJobGroups(java.sql.Connection conn)
                                   throws java.sql.SQLException

Select all of the job group names that are stored.

Parameters:

conn - the DB Connection

Returns:

an array of String group names

Throws:

java.sql.SQLException

selectJobsInGroup

public java.lang.String[] selectJobsInGroup(java.sql.Connection conn,
                                   java.lang.String groupName)
                                     throws java.sql.SQLException

Select all of the jobs contained in a given group.

Parameters:

conn - the DB Connection

groupName - the group containing the jobs

Returns:

an array of String job names

Throws:

java.sql.SQLException

insertTrigger

public int insertTrigger(java.sql.Connection conn,
                Trigger trigger,
                java.lang.String state,
                JobDetail jobDetail)
                  throws java.sql.SQLException,
                         java.io.IOException

Insert the base trigger data.

Parameters:

conn - the DB Connection

trigger - the trigger to insert

state - the state that the trigger should be stored in

Returns:

the number of rows inserted

Throws:

java.sql.SQLException

java.io.IOException

insertSimpleTrigger

public int insertSimpleTrigger(java.sql.Connection conn,
                      SimpleTrigger trigger)
                        throws java.sql.SQLException

Insert the simple trigger data.

Parameters:

conn - the DB Connection

trigger - the trigger to insert

Returns:

the number of rows inserted

Throws:

java.sql.SQLException

insertCronTrigger

public int insertCronTrigger(java.sql.Connection conn,
                    CronTrigger trigger)
                      throws java.sql.SQLException

Insert the cron trigger data.

Parameters:

conn - the DB Connection

trigger - the trigger to insert

Returns:

the number of rows inserted

Throws:

java.sql.SQLException

insertBlobTrigger

public int insertBlobTrigger(java.sql.Connection conn,
                    Trigger trigger)
                      throws java.sql.SQLException,
                             java.io.IOException

Insert the blob trigger data.

Parameters:

conn - the DB Connection

trigger - the trigger to insert

Returns:

the number of rows inserted

Throws:

java.sql.SQLException

java.io.IOException

updateTrigger

public int updateTrigger(java.sql.Connection conn,
                Trigger trigger,
                java.lang.String state,
                JobDetail jobDetail)
                  throws java.sql.SQLException,
                         java.io.IOException

Update the base trigger data.

Parameters:

conn - the DB Connection

trigger - the trigger to insert

state - the state that the trigger should be stored in

Returns:

the number of rows updated

Throws:

java.sql.SQLException

java.io.IOException

updateSimpleTrigger

public int updateSimpleTrigger(java.sql.Connection conn,
                      SimpleTrigger trigger)
                        throws java.sql.SQLException

Update the simple trigger data.

Parameters:

conn - the DB Connection

trigger - the trigger to insert

Returns:

the number of rows updated

Throws:

java.sql.SQLException

updateCronTrigger

public int updateCronTrigger(java.sql.Connection conn,
                    CronTrigger trigger)
                      throws java.sql.SQLException

Update the cron trigger data.

Parameters:

conn - the DB Connection

trigger - the trigger to insert

Returns:

the number of rows updated

Throws:

java.sql.SQLException

updateBlobTrigger

public int updateBlobTrigger(java.sql.Connection conn,
                    Trigger trigger)
                      throws java.sql.SQLException,
                             java.io.IOException

Update the blob trigger data.

Parameters:

conn - the DB Connection

trigger - the trigger to insert

Returns:

the number of rows updated

Throws:

java.sql.SQLException

java.io.IOException

triggerExists

public boolean triggerExists(java.sql.Connection conn,
                    java.lang.String triggerName,
                    java.lang.String groupName)
                      throws java.sql.SQLException

Check whether or not a trigger exists.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

true if the trigger exists, false otherwise

Throws:

java.sql.SQLException

updateTriggerState

public int updateTriggerState(java.sql.Connection conn,
                     java.lang.String triggerName,
                     java.lang.String groupName,
                     java.lang.String state)
                       throws java.sql.SQLException

Update the state for a given trigger.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

state - the new state for the trigger

Returns:

the number of rows updated

Throws:

java.sql.SQLException

updateTriggerStateFromOtherStates

public int updateTriggerStateFromOtherStates(java.sql.Connection conn,
                                    java.lang.String triggerName,
                                    java.lang.String groupName,
                                    java.lang.String newState,
                                    java.lang.String oldState1,
                                    java.lang.String oldState2,
                                    java.lang.String oldState3)
                                      throws java.sql.SQLException

Update the given trigger to the given new state, if it is one of the given old states.

Parameters:

conn - the DB connection

triggerName - the name of the trigger

groupName - the group containing the trigger

newState - the new state for the trigger

oldState1 - one of the old state the trigger must be in

oldState2 - one of the old state the trigger must be in

oldState3 - one of the old state the trigger must be in

Returns:

int the number of rows updated

Throws:

java.sql.SQLException

updateTriggerStateFromOtherStatesBeforeTime

public int updateTriggerStateFromOtherStatesBeforeTime(java.sql.Connection conn,
                                              java.lang.String newState,
                                              java.lang.String oldState1,
                                              java.lang.String oldState2,
                                              long time)
                                                throws java.sql.SQLException

Update the all triggers to the given new state, if they are in one of the given old states AND its next fire time is before the given time.

Parameters:

conn - the DB connection

newState - the new state for the trigger

oldState1 - one of the old state the trigger must be in

oldState2 - one of the old state the trigger must be in

time - the time before which the trigger's next fire time must be

Returns:

int the number of rows updated

Throws:

java.sql.SQLException

updateTriggerGroupStateFromOtherStates

public int updateTriggerGroupStateFromOtherStates(java.sql.Connection conn,
                                         java.lang.String groupName,
                                         java.lang.String newState,
                                         java.lang.String oldState1,
                                         java.lang.String oldState2,
                                         java.lang.String oldState3)
                                           throws java.sql.SQLException

Update all triggers in the given group to the given new state, if they are in one of the given old states.

Parameters:

conn - the DB connection

groupName - the group containing the trigger

newState - the new state for the trigger

oldState1 - one of the old state the trigger must be in

oldState2 - one of the old state the trigger must be in

oldState3 - one of the old state the trigger must be in

Returns:

int the number of rows updated

Throws:

java.sql.SQLException

updateTriggerStateFromOtherState

public int updateTriggerStateFromOtherState(java.sql.Connection conn,
                                   java.lang.String triggerName,
                                   java.lang.String groupName,
                                   java.lang.String newState,
                                   java.lang.String oldState)
                                     throws java.sql.SQLException

Update the given trigger to the given new state, if it is in the given old state.

Parameters:

conn - the DB connection

triggerName - the name of the trigger

groupName - the group containing the trigger

newState - the new state for the trigger

oldState - the old state the trigger must be in

Returns:

int the number of rows updated

Throws:

java.sql.SQLException

updateTriggerGroupStateFromOtherState

public int updateTriggerGroupStateFromOtherState(java.sql.Connection conn,
                                        java.lang.String groupName,
                                        java.lang.String newState,
                                        java.lang.String oldState)
                                          throws java.sql.SQLException

Update all of the triggers of the given group to the given new state, if they are in the given old state.

Parameters:

conn - the DB connection

groupName - the group containing the triggers

newState - the new state for the trigger group

oldState - the old state the triggers must be in

Returns:

int the number of rows updated

Throws:

java.sql.SQLException

updateTriggerStatesForJob

public int updateTriggerStatesForJob(java.sql.Connection conn,
                            java.lang.String jobName,
                            java.lang.String groupName,
                            java.lang.String state)
                              throws java.sql.SQLException

Update the states of all triggers associated with the given job.

Parameters:

conn - the DB Connection

jobName - the name of the job

groupName - the group containing the job

state - the new state for the triggers

Returns:

the number of rows updated

Throws:

java.sql.SQLException

updateTriggerStatesForJobFromOtherState

public int updateTriggerStatesForJobFromOtherState(java.sql.Connection conn,
                                          java.lang.String jobName,
                                          java.lang.String groupName,
                                          java.lang.String state,
                                          java.lang.String oldState)
                                            throws java.sql.SQLException

Update the states of any triggers associated with the given job, that are the given current state.

Parameters:

conn - the DB Connection

jobName - the name of the job

groupName - the group containing the job

state - the new state for the triggers

oldState - the old state of the triggers

Returns:

the number of rows updated

Throws:

java.sql.SQLException

deleteTriggerListeners

public int deleteTriggerListeners(java.sql.Connection conn,
                         java.lang.String triggerName,
                         java.lang.String groupName)
                           throws java.sql.SQLException

Delete all of the listeners associated with a given trigger.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger whose listeners will be deleted

groupName - the name of the group containing the trigger

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

insertTriggerListener

public int insertTriggerListener(java.sql.Connection conn,
                        Trigger trigger,
                        java.lang.String listener)
                          throws java.sql.SQLException

Associate a listener with the given trigger.

Parameters:

conn - the DB Connection

trigger - the trigger

listener - the name of the listener to associate with the trigger

Returns:

the number of rows inserted

Throws:

java.sql.SQLException

selectTriggerListeners

public java.lang.String[] selectTriggerListeners(java.sql.Connection conn,
                                        java.lang.String triggerName,
                                        java.lang.String groupName)
                                          throws java.sql.SQLException

Select the listeners associated with a given trigger.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

array of String trigger listener names

Throws:

java.sql.SQLException

deleteSimpleTrigger

public int deleteSimpleTrigger(java.sql.Connection conn,
                      java.lang.String triggerName,
                      java.lang.String groupName)
                        throws java.sql.SQLException

Delete the simple trigger data for a trigger.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

deleteCronTrigger

public int deleteCronTrigger(java.sql.Connection conn,
                    java.lang.String triggerName,
                    java.lang.String groupName)
                      throws java.sql.SQLException

Delete the cron trigger data for a trigger.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

deleteBlobTrigger

public int deleteBlobTrigger(java.sql.Connection conn,
                    java.lang.String triggerName,
                    java.lang.String groupName)
                      throws java.sql.SQLException

Delete the cron trigger data for a trigger.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

deleteTrigger

public int deleteTrigger(java.sql.Connection conn,
                java.lang.String triggerName,
                java.lang.String groupName)
                  throws java.sql.SQLException

Delete the base trigger data for a trigger.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

selectNumTriggersForJob

public int selectNumTriggersForJob(java.sql.Connection conn,
                          java.lang.String jobName,
                          java.lang.String groupName)
                            throws java.sql.SQLException

Select the number of triggers associated with a given job.

Parameters:

conn - the DB Connection

jobName - the name of the job

groupName - the group containing the job

Returns:

the number of triggers for the given job

Throws:

java.sql.SQLException

selectJobForTrigger

public JobDetail selectJobForTrigger(java.sql.Connection conn,
                            java.lang.String triggerName,
                            java.lang.String groupName,
                            ClassLoadHelper loadHelper)
                              throws java.lang.ClassNotFoundException,
                                     java.sql.SQLException

Select the job to which the trigger is associated.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

the JobDetail object associated with the given trigger

Throws:

java.sql.SQLException

java.lang.ClassNotFoundException

selectTriggersForJob

public Trigger[] selectTriggersForJob(java.sql.Connection conn,
                             java.lang.String jobName,
                             java.lang.String groupName)
                               throws java.sql.SQLException,
                                      java.lang.ClassNotFoundException,
                                      java.io.IOException

Select the triggers for a job

Parameters:

conn - the DB Connection

jobName - the name of the trigger

groupName - the group containing the trigger

Returns:

an array of (@link org.quartz.Trigger) objects associated with a given job.

Throws:

java.sql.SQLException

java.lang.ClassNotFoundException

java.io.IOException

selectTriggersForCalendar

public Trigger[] selectTriggersForCalendar(java.sql.Connection conn,
                                  java.lang.String calName)
                                    throws java.sql.SQLException,
                                           java.lang.ClassNotFoundException,
                                           java.io.IOException

Select the triggers for a calendar

Parameters:

conn - the DB Connection

calName - the name of the calendar

Returns:

an array of (@link org.quartz.Trigger) objects associated with the given calendar.

Throws:

java.sql.SQLException

java.lang.ClassNotFoundException

java.io.IOException

selectStatefulJobsOfTriggerGroup

public java.util.List selectStatefulJobsOfTriggerGroup(java.sql.Connection conn,
                                              java.lang.String groupName)
                                                throws java.sql.SQLException

Select the stateful jobs which are referenced by triggers in the given trigger group.

Parameters:

conn - the DB Connection

groupName - the trigger group

Returns:

a List of Keys to jobs.

Throws:

java.sql.SQLException

selectTrigger

public Trigger selectTrigger(java.sql.Connection conn,
                    java.lang.String triggerName,
                    java.lang.String groupName)
                      throws java.sql.SQLException,
                             java.lang.ClassNotFoundException,
                             java.io.IOException

Select a trigger.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

the Trigger object

Throws:

java.sql.SQLException

java.lang.ClassNotFoundException

java.io.IOException

selectTriggerJobDataMap

public JobDataMap selectTriggerJobDataMap(java.sql.Connection conn,
                                 java.lang.String triggerName,
                                 java.lang.String groupName)
                                   throws java.sql.SQLException,
                                          java.lang.ClassNotFoundException,
                                          java.io.IOException

Select a trigger's JobDataMap.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

the JobDataMap of the Trigger, never null, but possibly empty.

Throws:

java.sql.SQLException

java.lang.ClassNotFoundException

java.io.IOException

selectTriggerState

public java.lang.String selectTriggerState(java.sql.Connection conn,
                                  java.lang.String triggerName,
                                  java.lang.String groupName)
                                    throws java.sql.SQLException

Select a trigger' state value.

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

the Trigger object

Throws:

java.sql.SQLException

selectTriggerStatus

public TriggerStatus selectTriggerStatus(java.sql.Connection conn,
                                java.lang.String triggerName,
                                java.lang.String groupName)
                                  throws java.sql.SQLException

Select a trigger' status (state & next fire time).

Parameters:

conn - the DB Connection

triggerName - the name of the trigger

groupName - the group containing the trigger

Returns:

a TriggerStatus object, or null

Throws:

java.sql.SQLException

selectNumTriggers

public int selectNumTriggers(java.sql.Connection conn)
                      throws java.sql.SQLException

Select the total number of triggers stored.

Parameters:

conn - the DB Connection

Returns:

the total number of triggers stored

Throws:

java.sql.SQLException

selectTriggerGroups

public java.lang.String[] selectTriggerGroups(java.sql.Connection conn)
                                       throws java.sql.SQLException

Select all of the trigger group names that are stored.

Parameters:

conn - the DB Connection

Returns:

an array of String group names

Throws:

java.sql.SQLException

selectTriggersInGroup

public java.lang.String[] selectTriggersInGroup(java.sql.Connection conn,
                                       java.lang.String groupName)
                                         throws java.sql.SQLException

Select all of the triggers contained in a given group.

Parameters:

conn - the DB Connection

groupName - the group containing the triggers

Returns:

an array of String trigger names

Throws:

java.sql.SQLException

insertPausedTriggerGroup

public int insertPausedTriggerGroup(java.sql.Connection conn,
                           java.lang.String groupName)
                             throws java.sql.SQLException

Throws:

java.sql.SQLException

deletePausedTriggerGroup

public int deletePausedTriggerGroup(java.sql.Connection conn,
                           java.lang.String groupName)
                             throws java.sql.SQLException

Throws:

java.sql.SQLException

deleteAllPausedTriggerGroups

public int deleteAllPausedTriggerGroups(java.sql.Connection conn)
                                 throws java.sql.SQLException

Throws:

java.sql.SQLException

isTriggerGroupPaused

public boolean isTriggerGroupPaused(java.sql.Connection conn,
                           java.lang.String groupName)
                             throws java.sql.SQLException

Throws:

java.sql.SQLException

isExistingTriggerGroup

public boolean isExistingTriggerGroup(java.sql.Connection conn,
                             java.lang.String groupName)
                               throws java.sql.SQLException

Throws:

java.sql.SQLException

insertCalendar

public int insertCalendar(java.sql.Connection conn,
                 java.lang.String calendarName,
                 Calendar calendar)
                   throws java.io.IOException,
                          java.sql.SQLException

Insert a new calendar.

Parameters:

conn - the DB Connection

calendarName - the name for the new calendar

calendar - the calendar

Returns:

the number of rows inserted

Throws:

java.io.IOException - if there were problems serializing the calendar

java.sql.SQLException

updateCalendar

public int updateCalendar(java.sql.Connection conn,
                 java.lang.String calendarName,
                 Calendar calendar)
                   throws java.io.IOException,
                          java.sql.SQLException

Update a calendar.

Parameters:

conn - the DB Connection

calendarName - the name for the new calendar

calendar - the calendar

Returns:

the number of rows updated

Throws:

java.io.IOException - if there were problems serializing the calendar

java.sql.SQLException

calendarExists

public boolean calendarExists(java.sql.Connection conn,
                     java.lang.String calendarName)
                       throws java.sql.SQLException

Check whether or not a calendar exists.

Parameters:

conn - the DB Connection

calendarName - the name of the calendar

Returns:

true if the trigger exists, false otherwise

Throws:

java.sql.SQLException

selectCalendar

public Calendar selectCalendar(java.sql.Connection conn,
                      java.lang.String calendarName)
                        throws java.lang.ClassNotFoundException,
                               java.io.IOException,
                               java.sql.SQLException

Select a calendar.

Parameters:

conn - the DB Connection

calendarName - the name of the calendar

Returns:

the Calendar

Throws:

java.lang.ClassNotFoundException - if a class found during deserialization cannot be found be found

java.io.IOException - if there were problems deserializing the calendar

java.sql.SQLException

calendarIsReferenced

public boolean calendarIsReferenced(java.sql.Connection conn,
                           java.lang.String calendarName)
                             throws java.sql.SQLException

Check whether or not a calendar is referenced by any triggers.

Parameters:

conn - the DB Connection

calendarName - the name of the calendar

Returns:

true if any triggers reference the calendar, false otherwise

Throws:

java.sql.SQLException

deleteCalendar

public int deleteCalendar(java.sql.Connection conn,
                 java.lang.String calendarName)
                   throws java.sql.SQLException

Delete a calendar.

Parameters:

conn - the DB Connection

calendarName - the name of the trigger

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

selectNumCalendars

public int selectNumCalendars(java.sql.Connection conn)
                       throws java.sql.SQLException

Select the total number of calendars stored.

Parameters:

conn - the DB Connection

Returns:

the total number of calendars stored

Throws:

java.sql.SQLException

selectCalendars

public java.lang.String[] selectCalendars(java.sql.Connection conn)
                                   throws java.sql.SQLException

Select all of the stored calendars.

Parameters:

conn - the DB Connection

Returns:

an array of String calendar names

Throws:

java.sql.SQLException

selectNextFireTime

public long selectNextFireTime(java.sql.Connection conn)
                        throws java.sql.SQLException

Deprecated. Does not account for misfires.

Select the next time that a trigger will be fired.

Parameters:

conn - the DB Connection

Returns:

the next fire time, or 0 if no trigger will be fired

Throws:

java.sql.SQLException

selectTriggerForFireTime

public Key selectTriggerForFireTime(java.sql.Connection conn,
                           long fireTime)
                             throws java.sql.SQLException

Select the trigger that will be fired at the given fire time.

Parameters:

conn - the DB Connection

fireTime - the time that the trigger will be fired

Returns:

a Key representing the trigger that will be fired at the given fire time, or null if no trigger will be fired at that time

Throws:

java.sql.SQLException

selectTriggerToAcquire

public java.util.List selectTriggerToAcquire(java.sql.Connection conn,
                                    long noLaterThan,
                                    long noEarlierThan)
                                      throws java.sql.SQLException

Select the next trigger which will fire to fire between the two given timestamps in ascending order of fire time, and then descending by priority.

Parameters:

conn - the DB Connection

noLaterThan - highest value of getNextFireTime() of the triggers (exclusive)

noEarlierThan - highest value of getNextFireTime() of the triggers (inclusive)

Returns:

A (never null, possibly empty) list of the identifiers (Key objects) of the next triggers to be fired.

Throws:

java.sql.SQLException

insertFiredTrigger

public int insertFiredTrigger(java.sql.Connection conn,
                     Trigger trigger,
                     java.lang.String state,
                     JobDetail job)
                       throws java.sql.SQLException

Insert a fired trigger.

Parameters:

conn - the DB Connection

trigger - the trigger

state - the state that the trigger should be stored in

Returns:

the number of rows inserted

Throws:

java.sql.SQLException

selectFiredTriggerRecords

public java.util.List selectFiredTriggerRecords(java.sql.Connection conn,
                                       java.lang.String triggerName,
                                       java.lang.String groupName)
                                         throws java.sql.SQLException

Select the states of all fired-trigger records for a given trigger, or trigger group if trigger name is null.

Returns:

a List of FiredTriggerRecord objects.

Throws:

java.sql.SQLException

selectFiredTriggerRecordsByJob

public java.util.List selectFiredTriggerRecordsByJob(java.sql.Connection conn,
                                            java.lang.String jobName,
                                            java.lang.String groupName)
                                              throws java.sql.SQLException

Select the states of all fired-trigger records for a given job, or job group if job name is null.

Returns:

a List of FiredTriggerRecord objects.

Throws:

java.sql.SQLException

selectInstancesFiredTriggerRecords

public java.util.List selectInstancesFiredTriggerRecords(java.sql.Connection conn,
                                                java.lang.String instanceName)
                                                  throws java.sql.SQLException

Select the states of all fired-trigger records for a given scheduler instance.

Returns:

a List of FiredTriggerRecord objects.

Throws:

java.sql.SQLException

selectFiredTriggerInstanceNames

public java.util.Set selectFiredTriggerInstanceNames(java.sql.Connection conn)
                                              throws java.sql.SQLException

Select the distinct instance names of all fired-trigger records.

This is useful when trying to identify orphaned fired triggers (a fired trigger without a scheduler state record.)

Returns:

a Set of String objects.

Throws:

java.sql.SQLException

deleteFiredTrigger

public int deleteFiredTrigger(java.sql.Connection conn,
                     java.lang.String entryId)
                       throws java.sql.SQLException

Delete a fired trigger.

Parameters:

conn - the DB Connection

entryId - the fired trigger entry to delete

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

selectJobExecutionCount

public int selectJobExecutionCount(java.sql.Connection conn,
                          java.lang.String jobName,
                          java.lang.String jobGroup)
                            throws java.sql.SQLException

Get the number instances of the identified job currently executing.

Parameters:

conn - the DB Connection

Returns:

the number instances of the identified job currently executing.

Throws:

java.sql.SQLException

deleteVolatileFiredTriggers

public int deleteVolatileFiredTriggers(java.sql.Connection conn)
                                throws java.sql.SQLException

Delete all volatile fired triggers.

Parameters:

conn - the DB Connection

Returns:

the number of rows deleted

Throws:

java.sql.SQLException

insertSchedulerState

public int insertSchedulerState(java.sql.Connection conn,
                       java.lang.String instanceId,
                       long checkInTime,
                       long interval)
                         throws java.sql.SQLException

Insert a scheduler-instance state record.

Parameters:

conn - the DB Connection

Returns:

the number of inserted rows.

Throws:

java.sql.SQLException

deleteSchedulerState

public int deleteSchedulerState(java.sql.Connection conn,
                       java.lang.String instanceId)
                         throws java.sql.SQLException

Delete a scheduler-instance state record.

Parameters:

conn - the DB Connection

Returns:

the number of deleted rows.

Throws:

java.sql.SQLException

updateSchedulerState

public int updateSchedulerState(java.sql.Connection conn,
                       java.lang.String instanceId,
                       long checkInTime)
                         throws java.sql.SQLException

Update a scheduler-instance state record.

Parameters:

conn - the DB Connection

Returns:

the number of updated rows.

Throws:

java.sql.SQLException

selectSchedulerStateRecords

public java.util.List selectSchedulerStateRecords(java.sql.Connection conn,
                                         java.lang.String instanceId)
                                           throws java.sql.SQLException

A List of all current SchedulerStateRecords.

If instanceId is not null, then only the record for the identified instance will be returned.

Parameters:

conn - the DB Connection

Throws:

java.sql.SQLException

selectVolatileTriggers

public Key[] selectVolatileTriggers(java.sql.Connection conn)
                             throws java.sql.SQLException

Get the names of all of the triggers that are volatile.

Parameters:

conn - the DB Connection

Returns:

an array of Key objects

Throws:

java.sql.SQLException

selectVolatileJobs

public Key[] selectVolatileJobs(java.sql.Connection conn)
                         throws java.sql.SQLException

Get the names of all of the jobs that are volatile.

Parameters:

conn - the DB Connection

Returns:

an array of Key objects

Throws:

java.sql.SQLException

selectPausedTriggerGroups

public java.util.Set selectPausedTriggerGroups(java.sql.Connection conn)
                                        throws java.sql.SQLException

Throws:

java.sql.SQLException

See Also:

DriverDelegate.selectPausedTriggerGroups(java.sql.Connection)