Quartz 1.6.1 Release Notes

This release contains some new features, many bug fixes and improvements to Quartz.

See the changelog below for complete details of this release.

Most Significant of New Features

• Trigger Priority. New 'priority' scheduling support - controls selection of the next trigger to fire in cases where multiple triggers are waiting. See Quartz Tutorial Lesson 4 for a description.

• JMS Integration. Some JMS-related features (such as a send-message job) are now included with Quartz. This feature set will increase over the next few releases of Quartz.

• Utility classes BroadcastSchedulerLister, FilterAndBroadcastJobListener, FilterAndBroadcastTriggerListener, and JobChainingJobListener

Other Key Changes

• Improvements to efficiency in several areas of the codebase.
• A Trigger is now not "acquired" by the scheduler until there is a thread available (in the ThreadPool) to execute it. This will lead to improved load balancing within a clustered setup, as well as other benefits.
• Ability to specify a locking semaphore implementation when using JDBC JobStore.
• Convenience classes JobListenerSupport, SchedulerListenerSupport, TriggerListenerSupport.
• Many more!

Core API changes

• Introduced Trigger.setPriority(int)

Migration Notes

Necessary Code Changes

Version	Description	Old Code	New Code
1.6.0	no changes necessary

Necessary Database Changes (if using JDBC-JobStore)

Version	Description	update command(s)
1.6.0	no changes necessary

Changelog

OpenSymphony JIRA (83 issues)
T	Key	Summary
	QUARTZ-35	Noisy stack-trace during shutdown
	QUARTZ-340	In JobRunShell.run() notifyJobStoreJobComplete exception always returns
	QUARTZ-372	Clarify Scheduler.getCurrentlyExecutingJobs()
	QUARTZ-398	Upgrade to Commons-Pool 1.3
	QUARTZ-419	CRON_EXPRESSION database field size too small
	QUARTZ-451	Upgrade to new versions of dependencies
	QUARTZ-465	A misfire that completes a Trigger does not notify SchedulerListener.triggerFinalized()
	QUARTZ-482	Missing Maven POMs
	QUARTZ-488	JobStoreCMT isTxIsolationLevelReadCommitted property sets TRANSACTION_READ_UNCOMMITTED
	QUARTZ-489	HSQLDB booleans broken for version 1.7.2+
	QUARTZ-513	EOFException being throw in StdJDBCDelegate.getObjectFromBlob for jobs with no jobdata
	QUARTZ-516	Errors in "tables-informix.sql" script file.
	QUARTZ-521	(reopen) RAMJobStore Trigger deletion infinite loop in acquireNextTrigger
	QUARTZ-522	db_tables/tables_informix.sql has systax errors - see updated version in description
	QUARTZ-525	More informations about potential Oracle DB lock
	QUARTZ-533	Bug when using '/' character in day-of-month expression in CronExpression/CronTrigger
	QUARTZ-536	Initialization resource files are opened but never closed
	QUARTZ-538	WebLogicOracleDelegate throws java.lang.NoSuchMethodException: weblogic.jdbc.base.BaseBlob.putBytes(long, [B)
	QUARTZ-539	Bugs in JMS SendQueueMessageJob
	QUARTZ-543	updateAfterMisfire() not invoked by StdScheduler
	QUARTZ-545	org.quartz.ee.servlet.QuartzInitializerListener javadoc has misleading example
	QUARTZ-547	Daemon thread property specified in the documentation is incorrect.
	QUARTZ-549	NthIncludedDayTriggerTest won't pass
	QUARTZ-550	readme.txt lists incorrect Ant version
	QUARTZ-551	Build problems with trunk
	QUARTZ-553	JobDetail.clone() does not preserve the order of job listeners
	QUARTZ-554	Trigger.getNextFireTime() returns date in the past
	QUARTZ-555	SimpleSemaphore.java contains concurrency bug that can cause
	QUARTZ-557	Cron/Simple Trigger may return a firing time not included in the calender
	QUARTZ-558	NullPointerException cloning CronTrigger without cron expression
	QUARTZ-559	Example6 BadJob1.java calls incorrect function
	QUARTZ-560	Trigger with empty JobDataMap can't be loaded in Derby and HSQLDB
	QUARTZ-562	Remove dependency on jta.jar for non-J2EE environments
	QUARTZ-563	RAMJobStore.triggerFired() fails to return null in some cases
	QUARTZ-564	misspelled class name
	QUARTZ-565	Example's job.xml has error in quartz 1.6.0
	QUARTZ-566	MSSQLDelegate.getObjectFromBlob throws org.quartz.JobPersistenceException: Couldn't obtain triggers for job: null [See nested exception: java.io.EOFException]
	QUARTZ-568	jms.jar corrupt
	QUARTZ-571	CronExpression is not building the expression correctly after being deserialized
	QUARTZ-573	Misleading Javadoc for org.quartz.Trigger getPreviousFireTime function.
	QUARTZ-574	CronExpression.storeExpressionVals miscalculates month number for invalid month names
	QUARTZ-577	JobInitializationPlugin can't find quartz-jobs.xml within a JAR file
	QUARTZ-579	regression on timezone support of crontrigger
	QUARTZ-580	NthIncludedDayTrigger.getFireAtTime() method result does not match the result that is documented in Javadoc.
	QUARTZ-581	NullPointerException in RAMJobStore.applyMisfire
	QUARTZ-582	"Stuck ACQUIRED triggers" / race condition with quartz
	QUARTZ-586	Please emphasize how to shutdown Quartz
	QUARTZ-588	Spelling errors in JavaDoc for SimpleTrigger
	QUARTZ-589	Method AnnualCalendar.setDayExcluded() seems to ignore the second parameter and always exclude the specified day.
	QUARTZ-590	Implementation of AnnualCalendar.setDaysExcluded() does not protect the parameter days against setting it to null.
	QUARTZ-591	Making methods setTimeRange() public in org.quartz.impl.calendar.DailyCalendar
	QUARTZ-595	When user Cron Expression 0 0 19 LW * ?, and Australia/Sydney timezone local computer is GMT, the next firetime will always be the current day when the last day of the month is on a weekend.
	QUARTZ-599	Syntax mistakes in Informix db create scripts
	QUARTZ-600	Trigger storing change breaks things for Spring's custom triggers
	QUARTZ-601	CronExpression over Midnight causes exception
	QUARTZ-606	RamJobStore.storeTrigger incorrectly removes JobDetail when replacing trigger
	QUARTZ-607	log job name when storing job or storing trigger for job fails
	QUARTZ-613	Instances in cluster check for failed instances after hardcoded interval of 7500 millis
	QUARTZ-619	Update applicationContext to Spring 2.0
	QUARTZ-620	Changes made in getJobDetail.getJobDataMap() by JobListener are not reflected in the getMergedJobDataMap()
	QUARTZ-621	incorrect results from CronExpression.isValidExpression()
	QUARTZ-625	NullPointer in org.quartz.utils.Pair.hashCode() method
	QUARTZ-627	QuartzScheduler.scheduleJob does not properly handle case where trigger job name equals the job name, but job group is null.
	QUARTZ-632	CLONE -Scheduling change causes a paused/blocked scheduler to do unnecessary trigger release
	QUARTZ-636	MonthlyCalendar getNextIncludedTime: infinite loop if included date > 7
	QUARTZ-638	QuartzSchedulerThread.signaled should be marked with the volatile modifier or should be an AtomicBoolean
	QUARTZ-639	JobDataMap getIntValue returns long
	QUARTZ-640	The Cron Expression do not support day of week list with "L" in it.
	QUARTZ-641	Invalid run triggers with startTime older than about 248 days
	QUARTZ-644	examples do not run in Windows when there is space in the classpath
	QUARTZ-645	Frequent deadlock on QRTZ_TRIGGERS table
	QUARTZ-646	Job Scheduler functionality using Quartz accumulates lots of records into its related tables in DB.
	QUARTZ-649	deadlock and out of memory problems
	QUARTZ-650	SimpleTrigger.computeFirstFireTime() method can get into infinite loop
	QUARTZ-651	Clarifying the documentation for misfire instructions
	QUARTZ-654	sybase dbTables script
	QUARTZ-656	The query SELECT_NEXT_TRIGGER_TO_ACQUIRE is incorrect for certain SQL servers
	QUARTZ-657	Deadlock in RAMJobStore
	QUARTZ-658	Introduce mechanism for delaying the starttup of the scheduler
	QUARTZ-659	RamJobStore does not remember paused job groups
	QUARTZ-660	Build failure in en_GB.UTF-8 locale in AnnualCalendarTest
	QUARTZ-661	CLONE -"Stuck ACQUIRED triggers" / race condition with quartz
	QUARTZ-662	NullPointerException in NthIncludedDayTrigger.getFinalFireTime()