org.quartz.impl.jdbcjobstore.JobStoreTX.bak Maven / Gradle / Ivy
/*
* Copyright 2004-2005 OpenSymphony
*
* 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.
*
*/
/*
* Previously Copyright (c) 2001-2004 James House
*/
package org.quartz.impl.jdbcjobstore;
import org.quartz.Calendar;
import org.quartz.JobDetail;
import org.quartz.JobPersistenceException;
import org.quartz.ObjectAlreadyExistsException;
import org.quartz.SchedulerConfigException;
import org.quartz.SchedulerException;
import org.quartz.Trigger;
import org.quartz.core.SchedulingContext;
import org.quartz.spi.ClassLoadHelper;
import org.quartz.spi.SchedulerSignaler;
import org.quartz.spi.TriggerFiredBundle;
import java.sql.Connection;
import java.util.List;
import java.util.Set;
/**
*
* JobStoreTX
is meant to be used in a standalone environment.
* Both commit and rollback will be handled by this class.
*
*
*
* If you need a {@link org.quartz.spi.JobStore}
class to use
* within an application-server environment, use {@link
* org.quartz.impl.jdbcjobstore.JobStoreCMT}
* instead.
*
*
* @author Jeffrey Wescott
* @author James House
*/
public class JobStoreTX extends JobStoreSupport {
/*
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*
* Interface.
*
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*/
public void initialize(ClassLoadHelper loadHelper,
SchedulerSignaler signaler) throws SchedulerConfigException {
super.initialize(loadHelper, signaler);
getLog().info("JobStoreTX initialized.");
}
//---------------------------------------------------------------------------
// JobStoreSupport methods
//---------------------------------------------------------------------------
/**
*
* Recover any failed or misfired jobs and clean up the data store as
* appropriate.
*
*
* @throws JobPersistenceException
* if jobs could not be recovered
*/
protected void recoverJobs() throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
recoverJobs(conn);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
protected void cleanVolatileTriggerAndJobs() throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
cleanVolatileTriggerAndJobs(conn);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
//---------------------------------------------------------------------------
// job / trigger storage methods
//---------------------------------------------------------------------------
/**
*
* Store the given {@link org.quartz.JobDetail}
and {@link org.quartz.Trigger}
.
*
*
* @param newJob
* The JobDetail
to be stored.
* @param newTrigger
* The Trigger
to be stored.
* @throws ObjectAlreadyExistsException
* if a Job
with the same name/group already
* exists.
*/
public void storeJobAndTrigger(SchedulingContext ctxt, JobDetail newJob,
Trigger newTrigger) throws ObjectAlreadyExistsException,
JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
if(isLockOnInsert()) {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
}
if (newJob.isVolatile() && !newTrigger.isVolatile()) {
JobPersistenceException jpe = new JobPersistenceException(
"Cannot associate non-volatile "
+ "trigger with a volatile job!");
jpe.setErrorCode(SchedulerException.ERR_CLIENT_ERROR);
throw jpe;
}
storeJob(conn, ctxt, newJob, false);
storeTrigger(conn, ctxt, newTrigger, newJob, false,
Constants.STATE_WAITING, false, false);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Store the given {@link org.quartz.JobDetail}
.
*
*
* @param newJob
* The JobDetail
to be stored.
* @param replaceExisting
* If true
, any Job
existing in the
* JobStore
with the same name & group should be
* over-written.
* @throws ObjectAlreadyExistsException
* if a Job
with the same name/group already
* exists, and replaceExisting is set to false.
*/
public void storeJob(SchedulingContext ctxt, JobDetail newJob,
boolean replaceExisting) throws ObjectAlreadyExistsException,
JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
if(isLockOnInsert() || replaceExisting) {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
}
storeJob(conn, ctxt, newJob, replaceExisting);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Remove (delete) the {@link org.quartz.Job}
with the given
* name, and any {@link org.quartz.Trigger}
s that reference
* it.
*
*
*
* If removal of the Job
results in an empty group, the
* group should be removed from the JobStore
's list of
* known group names.
*
*
* @param jobName
* The name of the Job
to be removed.
* @param groupName
* The group name of the Job
to be removed.
* @return true
if a Job
with the given name &
* group was found and removed from the store.
*/
public boolean removeJob(SchedulingContext ctxt, String jobName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
boolean removed = removeJob(conn, ctxt, jobName, groupName, true);
commitConnection(conn);
return removed;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Retrieve the {@link org.quartz.JobDetail}
for the given
* {@link org.quartz.Job}
.
*
*
* @param jobName
* The name of the Job
to be retrieved.
* @param groupName
* The group name of the Job
to be retrieved.
* @return The desired Job
, or null if there is no match.
*/
public JobDetail retrieveJob(SchedulingContext ctxt, String jobName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
JobDetail job = retrieveJob(conn, ctxt, jobName, groupName);
commitConnection(conn);
return job;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Store the given {@link org.quartz.Trigger}
.
*
*
* @param newTrigger
* The Trigger
to be stored.
* @param replaceExisting
* If true
, any Trigger
existing in
* the JobStore
with the same name & group should
* be over-written.
* @throws ObjectAlreadyExistsException
* if a Trigger
with the same name/group already
* exists, and replaceExisting is set to false.
*/
public void storeTrigger(SchedulingContext ctxt, Trigger newTrigger,
boolean replaceExisting) throws ObjectAlreadyExistsException,
JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
if(isLockOnInsert() || replaceExisting) {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
}
storeTrigger(conn, ctxt, newTrigger, null, replaceExisting,
STATE_WAITING, false, false);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Remove (delete) the {@link org.quartz.Trigger}
with the
* given name.
*
*
*
* If removal of the Trigger
results in an empty group, the
* group should be removed from the JobStore
's list of
* known group names.
*
*
*
* If removal of the Trigger
results in an 'orphaned' Job
* that is not 'durable', then the Job
should be deleted
* also.
*
*
* @param triggerName
* The name of the Trigger
to be removed.
* @param groupName
* The group name of the Trigger
to be removed.
* @return true
if a Trigger
with the given
* name & group was found and removed from the store.
*/
public boolean removeTrigger(SchedulingContext ctxt, String triggerName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
boolean removed = removeTrigger(conn, ctxt, triggerName, groupName);
commitConnection(conn);
return removed;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
* @see org.quartz.spi.JobStore#replaceTrigger(org.quartz.core.SchedulingContext, java.lang.String, java.lang.String, org.quartz.Trigger)
*/
public boolean replaceTrigger(SchedulingContext ctxt, String triggerName, String groupName, Trigger newTrigger) throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
boolean removed = replaceTrigger(conn, ctxt, triggerName, groupName, newTrigger);
commitConnection(conn);
return removed;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Retrieve the given {@link org.quartz.Trigger}
.
*
*
* @param triggerName
* The name of the Trigger
to be retrieved.
* @param groupName
* The group name of the Trigger
to be retrieved.
* @return The desired Trigger
, or null if there is no
* match.
*/
public Trigger retrieveTrigger(SchedulingContext ctxt, String triggerName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
Trigger trigger = retrieveTrigger(conn, ctxt, triggerName,
groupName);
commitConnection(conn);
return trigger;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Store the given {@link org.quartz.Calendar}
.
*
*
* @param calName
* The name of the calendar.
* @param calendar
* The Calendar
to be stored.
* @param replaceExisting
* If true
, any Calendar
existing
* in the JobStore
with the same name & group
* should be over-written.
* @throws ObjectAlreadyExistsException
* if a Calendar
with the same name already
* exists, and replaceExisting is set to false.
*/
public void storeCalendar(SchedulingContext ctxt, String calName,
Calendar calendar, boolean replaceExisting, boolean updateTriggers)
throws ObjectAlreadyExistsException, JobPersistenceException {
Connection conn = getConnection();
boolean lockOwner = false;
try {
if(isLockOnInsert() || updateTriggers) {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
lockOwner = true;
}
storeCalendar(conn, ctxt, calName, calendar, replaceExisting, updateTriggers);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, lockOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Remove (delete) the {@link org.quartz.Calendar}
with the
* given name.
*
*
*
* If removal of the Calendar
would result in
* s pointing to non-existent calendars, then a
* JobPersistenceException
will be thrown.
* *
* @param calName The name of the Calendar
to be removed.
* @return true
if a Calendar
with the given name
* was found and removed from the store.
*/
public boolean removeCalendar(SchedulingContext ctxt, String calName)
throws JobPersistenceException {
Connection conn = getConnection();
boolean lockOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
lockOwner = true;
boolean removed = removeCalendar(conn, ctxt, calName);
commitConnection(conn);
return removed;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, lockOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Retrieve the given {@link org.quartz.Trigger}
.
*
*
* @param calName
* The name of the Calendar
to be retrieved.
* @return The desired Calendar
, or null if there is no
* match.
*/
public Calendar retrieveCalendar(SchedulingContext ctxt, String calName)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
Calendar cal = retrieveCalendar(conn, ctxt, calName);
commitConnection(conn);
return cal;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
//---------------------------------------------------------------------------
// informational methods
//---------------------------------------------------------------------------
/**
*
* Get the number of {@link org.quartz.Job}
s that are
* stored in the JobStore
.
*
*/
public int getNumberOfJobs(SchedulingContext ctxt)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
int numJobs = getNumberOfJobs(conn, ctxt);
commitConnection(conn);
return numJobs;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Get the number of {@link org.quartz.Trigger}
s that are
* stored in the JobsStore
.
*
*/
public int getNumberOfTriggers(SchedulingContext ctxt)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
int numTriggers = getNumberOfTriggers(conn, ctxt);
commitConnection(conn);
return numTriggers;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Get the number of {@link org.quartz.Calendar}
s that are
* stored in the JobsStore
.
*
*/
public int getNumberOfCalendars(SchedulingContext ctxt)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
int numCals = getNumberOfCalendars(conn, ctxt);
commitConnection(conn);
return numCals;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
public Set getPausedTriggerGroups(SchedulingContext ctxt)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
Set groups = getPausedTriggerGroups(conn, ctxt);
commitConnection(conn);
return groups;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Get the names of all of the {@link org.quartz.Job}
s that
* have the given group name.
*
*
*
* If there are no jobs in the given group name, the result should be a
* zero-length array (not null
).
*
*/
public String[] getJobNames(SchedulingContext ctxt, String groupName)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
String[] jobNames = getJobNames(conn, ctxt, groupName);
commitConnection(conn);
return jobNames;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Get the names of all of the {@link org.quartz.Trigger}
s
* that have the given group name.
*
*
*
* If there are no triggers in the given group name, the result should be a
* zero-length array (not null
).
*
*/
public String[] getTriggerNames(SchedulingContext ctxt, String groupName)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
String[] triggerNames = getTriggerNames(conn, ctxt, groupName);
commitConnection(conn);
return triggerNames;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Get the names of all of the {@link org.quartz.Job}
* groups.
*
*
*
* If there are no known group names, the result should be a zero-length
* array (not null
).
*
*/
public String[] getJobGroupNames(SchedulingContext ctxt)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
String[] groupNames = getJobGroupNames(conn, ctxt);
commitConnection(conn);
return groupNames;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Get the names of all of the {@link org.quartz.Trigger}
* groups.
*
*
*
* If there are no known group names, the result should be a zero-length
* array (not null
).
*
*/
public String[] getTriggerGroupNames(SchedulingContext ctxt)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
String[] triggerGroups = getTriggerGroupNames(conn, ctxt);
commitConnection(conn);
return triggerGroups;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Get the names of all of the {@link org.quartz.Calendar}
s
* in the JobStore
.
*
*
*
* If there are no Calendars in the given group name, the result should be
* a zero-length array (not null
).
*
*/
public String[] getCalendarNames(SchedulingContext ctxt)
throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
String[] calNames = getCalendarNames(conn, ctxt);
commitConnection(conn);
return calNames;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Get all of the Triggers that are associated to the given Job.
*
*
*
* If there are no matches, a zero-length array should be returned.
*
*/
public Trigger[] getTriggersForJob(SchedulingContext ctxt, String jobName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
return getTriggersForJob(conn, ctxt, jobName, groupName);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
/**
*
* Get the current state of the identified {@link Trigger}
.
*
*
* @see Trigger#STATE_NORMAL
* @see Trigger#STATE_PAUSED
* @see Trigger#STATE_COMPLETE
* @see Trigger#STATE_ERROR
* @see Trigger#STATE_NONE
*/
public int getTriggerState(SchedulingContext ctxt, String triggerName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
try {
// no locks necessary for read...
return getTriggerState(conn, ctxt, triggerName, groupName);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
closeConnection(conn);
}
}
//---------------------------------------------------------------------------
// trigger state manipulation methods
//---------------------------------------------------------------------------
/**
*
* Pause the {@link org.quartz.Trigger}
with the given name.
*
*
* @see #resumeTrigger(SchedulingContext, String, String)
*/
public void pauseTrigger(SchedulingContext ctxt, String triggerName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
pauseTrigger(conn, ctxt, triggerName, groupName);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Pause all of the {@link org.quartz.Trigger}s
in the
* given group.
*
*
* @see #resumeTriggerGroup(SchedulingContext, String)
*/
public void pauseTriggerGroup(SchedulingContext ctxt, String groupName)
throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
pauseTriggerGroup(conn, ctxt, groupName);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Pause the {@link org.quartz.Job}
with the given name - by
* pausing all of its current Trigger
s.
*
*
* @see #resumeJob(SchedulingContext, String, String)
*/
public void pauseJob(SchedulingContext ctxt, String jobName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
Trigger[] triggers = getTriggersForJob(conn, ctxt, jobName,
groupName);
for (int j = 0; j < triggers.length; j++) {
pauseTrigger(conn, ctxt, triggers[j].getName(), triggers[j]
.getGroup());
}
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Pause all of the {@link org.quartz.Job}s
in the given
* group - by pausing all of their Trigger
s.
*
*
* @see #resumeJobGroup(SchedulingContext, String)
*/
public void pauseJobGroup(SchedulingContext ctxt, String groupName)
throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
String[] jobNames = getJobNames(conn, ctxt, groupName);
for (int i = 0; i < jobNames.length; i++) {
Trigger[] triggers = getTriggersForJob(conn, ctxt, jobNames[i],
groupName);
for (int j = 0; j < triggers.length; j++) {
pauseTrigger(conn, ctxt, triggers[j].getName(), triggers[j]
.getGroup());
}
}
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Resume (un-pause) the {@link org.quartz.Trigger}
with the
* given name.
*
*
*
* If the Trigger
missed one or more fire-times, then the
* Trigger
's misfire instruction will be applied.
*
*
* @see #pauseTrigger(SchedulingContext, String, String)
*/
public void resumeTrigger(SchedulingContext ctxt, String triggerName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
resumeTrigger(conn, ctxt, triggerName, groupName);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Resume (un-pause) all of the {@link org.quartz.Trigger}s
* in the given group.
*
*
*
* If any Trigger
missed one or more fire-times, then the
* Trigger
's misfire instruction will be applied.
*
*
* @see #pauseTriggerGroup(SchedulingContext, String)
*/
public void resumeTriggerGroup(SchedulingContext ctxt, String groupName)
throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
resumeTriggerGroup(conn, ctxt, groupName);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Resume (un-pause) the {@link org.quartz.Job}
with the
* given name.
*
*
*
* If any of the Job
'sTrigger
s missed one
* or more fire-times, then the Trigger
's misfire
* instruction will be applied.
*
*
* @see #pauseJob(SchedulingContext, String, String)
*/
public void resumeJob(SchedulingContext ctxt, String jobName,
String groupName) throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
Trigger[] triggers = getTriggersForJob(conn, ctxt, jobName,
groupName);
for (int j = 0; j < triggers.length; j++) {
resumeTrigger(conn, ctxt, triggers[j].getName(), triggers[j]
.getGroup());
}
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Resume (un-pause) all of the {@link org.quartz.Job}s
in
* the given group.
*
*
*
* If any of the Job
s had Trigger
s that
* missed one or more fire-times, then the Trigger
's
* misfire instruction will be applied.
*
*
* @see #pauseJobGroup(SchedulingContext, String)
*/
public void resumeJobGroup(SchedulingContext ctxt, String groupName)
throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
String[] jobNames = getJobNames(conn, ctxt, groupName);
for (int i = 0; i < jobNames.length; i++) {
Trigger[] triggers = getTriggersForJob(conn, ctxt, jobNames[i],
groupName);
for (int j = 0; j < triggers.length; j++) {
resumeTrigger(conn, ctxt, triggers[j].getName(),
triggers[j].getGroup());
}
}
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Pause all triggers - equivalent of calling pauseTriggerGroup(group)
* on every group.
*
*
*
* When resumeAll()
is called (to un-pause), trigger misfire
* instructions WILL be applied.
*
*
* @see #resumeAll(SchedulingContext)
* @see #pauseTriggerGroup(SchedulingContext, String)
*/
public void pauseAll(SchedulingContext ctxt) throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
pauseAll(conn, ctxt);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Resume (un-pause) all triggers - equivalent of calling resumeTriggerGroup(group)
* on every group.
*
*
*
* If any Trigger
missed one or more fire-times, then the
* Trigger
's misfire instruction will be applied.
*
*
* @see #pauseAll(SchedulingContext)
*/
public void resumeAll(SchedulingContext ctxt)
throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
resumeAll(conn, ctxt);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
//---------------------------------------------------------------------------
// trigger firing methods
//---------------------------------------------------------------------------
/**
*
* Get a handle to the next trigger to be fired, and mark it as 'reserved'
* by the calling scheduler.
*
*
* @see #releaseAcquiredTrigger(SchedulingContext, Trigger)
*/
public Trigger acquireNextTrigger(SchedulingContext ctxt, long noLaterThan)
throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
Trigger trigger = acquireNextTrigger(conn, ctxt, noLaterThan);
commitConnection(conn);
return trigger;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Inform the JobStore
that the scheduler no longer plans to
* fire the given Trigger
, that it had previously acquired
* (reserved).
*
*/
public void releaseAcquiredTrigger(SchedulingContext ctxt, Trigger trigger)
throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
releaseAcquiredTrigger(conn, ctxt, trigger);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Inform the JobStore
that the scheduler is now firing the
* given Trigger
(executing its associated Job
),
* that it had previously acquired (reserved).
*
*
* @return null if the trigger or it's job or calendar no longer exist, or
* if the trigger was not successfully put into the 'executing'
* state.
*/
public TriggerFiredBundle triggerFired(SchedulingContext ctxt,
Trigger trigger) throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
TriggerFiredBundle tfb = null;
JobPersistenceException err = null;
try {
tfb = triggerFired(conn, ctxt, trigger);
} catch (JobPersistenceException jpe) {
if (jpe.getErrorCode() != SchedulerException.ERR_PERSISTENCE_JOB_DOES_NOT_EXIST)
throw jpe;
err = jpe;
}
commitConnection(conn);
if (err != null) throw err;
return tfb;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
/**
*
* Inform the JobStore
that the scheduler has completed the
* firing of the given Trigger
(and the execution its
* associated Job
), and that the {@link org.quartz.JobDataMap}
* in the given JobDetail
should be updated if the Job
* is stateful.
*
*/
public void triggeredJobComplete(SchedulingContext ctxt, Trigger trigger,
JobDetail jobDetail, int triggerInstCode)
throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
triggeredJobComplete(conn, ctxt, trigger, jobDetail,
triggerInstCode);
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
protected boolean doRecoverMisfires() throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
boolean moreToDo = false;
try {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
transOwner = true;
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
try {
moreToDo = recoverMisfiredJobs(conn, false);
} catch (Exception e) {
throw new JobPersistenceException(e.getMessage(), e);
}
commitConnection(conn);
return moreToDo;
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
closeConnection(conn);
}
}
}
protected boolean doCheckin() throws JobPersistenceException {
Connection conn = getConnection();
boolean transOwner = false;
boolean transStateOwner = false;
boolean recovered = false;
try {
getLockHandler().obtainLock(conn, LOCK_STATE_ACCESS);
transStateOwner = true;
List failedRecords = clusterCheckIn(conn);
if (failedRecords.size() > 0) {
getLockHandler().obtainLock(conn, LOCK_TRIGGER_ACCESS);
//getLockHandler().obtainLock(conn, LOCK_JOB_ACCESS);
transOwner = true;
clusterRecover(conn, failedRecords);
recovered = true;
}
commitConnection(conn);
} catch (JobPersistenceException e) {
rollbackConnection(conn);
throw e;
} finally {
try {
releaseLock(conn, LOCK_TRIGGER_ACCESS, transOwner);
} finally {
try {
releaseLock(conn, LOCK_STATE_ACCESS, transStateOwner);
} finally {
closeConnection(conn);
}
}
}
firstCheckIn = false;
return recovered;
}
}
// EOF