- Production System Tips
- JobDataMap Tips
- Trigger Tips
- JDBC JobStore
- Daylight Savings Time
- Listeners (TriggerListener, JobListener, SchedulerListener)
- Exposing Scheduler Functionality Through Applications
Best Practices and Tips
Production System Tips
Skip Update Check
Quartz contains an “update check” feature that connects to a server to check if there is a new version of Quartz available for download. This check runs asynchronously and does not affect startup/initialization time of Quartz, and it fails gracefully if the connection cannot be made. If the check runs, and an update is found, it will be reported as available in Quartz’s logs.
You can disable the update check with the Quartz config property “org.quartz.scheduler.skipUpdateCheck: true” or the system property “org.terracotta.quartz.skipUpdateCheck=true” (which you can set in your system environment or as a -D on the java command line). It is recommended that you disable the update check for production deployments.
Only Store Primitive Data Types (including Strings) In the JobDataMap
Bạn yêu cuộc sốngOnly store primitive data types (including Strings) in JobDataMap to avoid data serialization issues short and long-term.
Use the Merged JobDataMap
The JobDataMap that is found on the JobExecutionContext during Job execution serves as a convenience. It is a merge of the JobDataMap found on the JobDetail and the one found on the Trigger, with the value in the latter overriding any same-named values in the former.
Bạn yêu cuộc sốngStoring JobDataMap values on a Trigger can be useful in the case where you have a Job that is stored in the scheduler for regular/repeated use by multiple Triggers, yet with each independent triggering, you want to supply the Job with different data inputs.
In light of all of the above, we recommend as a best practice the following: Code within the Job.execute(..) method should generally retrieve values from the JobDataMap on found on the JobExecutionContext, rather than directly from the one on the JobDetail.
Use DateBuilder, TriggerBuilder and TriggerUtils.
Bạn yêu cuộc sốngDateBuilder:
Bạn yêu cuộc sốngOffers a simple way to create Dates (for start/end dates)
Offers a simpler way to create triggers (schedules)
Has various methods for creating triggers with schedules that meet particular descriptions, as opposed to directly instantiating triggers of a specific type (i.e. SimpleTrigger, CronTrigger, etc.) and then invoking various setter methods to configure them
TriggerUtils: * Offers helpers for analyzing triggers (e.g. calculating future fire times)
Never Write Directly To Quartz’s Tables
Writing scheduling data directly to the database (via SQL) rather than using scheduling API:
Bạn yêu cuộc sốngResults in data corruption (deleted data, scrambled data)
Results in job seemingly “vanishing” without executing when a trigger’s fire time arrives
Bạn yêu cuộc sốngResults in job not executing “just sitting there” when a trigger’s fire time arrives
Bạn yêu cuộc sốngMay result in: Dead-locks
Bạn yêu cuộc sốngOther strange problems and data corruption
Never Point A Non-Clustered Scheduler At the Same Database As Another Scheduler With The Same Scheduler Name
If you point more than one scheduler instance at the same set of database tables, and one or more of those instances is not configured for clustering, any of the following may occur:
Results in data corruption (deleted data, scrambled data)
Bạn yêu cuộc sốngResults in job seemingly “vanishing” without executing when a trigger’s fire time arrives
Bạn yêu cuộc sốngResults in job not executing, “just sitting there” when a trigger’s fire time arrives
May result in: Dead-locks
Other strange problems and data corruption
Ensure Adequate Datasource Connection Size
Bạn yêu cuộc sốngIt is recommended that your Datasource max connection size be configured to be at least the number of worker threads in the thread pool plus three. You may need additional connections if your application is also making frequent calls to the scheduler API. If you are using JobStoreCMT, the “non managed” datasource should have a maximum connection size of at least four.
Daylight Savings Time
Avoid Scheduling Jobs Near the Transition Hours of Daylight Savings Time
|Specifics of the transition hour and the amount of time the clock moves forward or back varies by locale see: .|
Bạn yêu cuộc sốngSimpleTriggers are not affected by Daylight Savings Time as they always fire at an exact millisecond in time, and repeat an exact number of milliseconds apart.
Because CronTriggers fire at given hours/minutes/seconds, they are subject to some oddities when DST transitions occur.
As an example of possible issues, scheduling in the United States within TimeZones/locations that observe Daylight Savings time, the following problems may occur if using CronTrigger and scheduling fire times during the hours of 1:00 AM and 2:00 AM:
1:05 AM may occur twice! - duplicate firings on CronTrigger possible
2:05 AM may never occur! - missed firings on CronTrigger possible
Again, specifics of time and amount of adjustment varies by locale.
Other trigger types that are based on sliding along a calendar (rather than exact amounts of time), such as CalenderIntervalTrigger, will be similarly affected - but rather than missing a firing, or firing twice, may end up having it’s fire time shifted by an hour.
Waiting For Conditions
Bạn yêu cuộc sốngLong-running jobs prevent others from running (if all threads in the ThreadPool are busy).
If you feel the need to call Thread.sleep() on the worker thread executing the Job, it is typically a sign that the job is not ready to do the rest of its work because it needs to wait for some condition (such as the availability of a data record) to become true.
A better solution is to release the worker thread (exit the job) and allow other jobs to execute on that thread. The job can reschedule itself, or other jobs before it exits.
A Job’s execute method should contain a try-catch block that handles all possible exceptions.
If a job throws an exception, Quartz will typically immediately re-execute it (and it will likely throw the same exception again). It’s better if the job catches all exception it may encounter, handle them, and reschedule itself, or other jobs. to work around the issue.
Recoverability and Idempotence
In-progress Jobs marked “recoverable” are automatically re-executed after a scheduler fails. This means some of the job’s "work" will be executed twice.
This means the job should be coded in such a way that its work is idempotent.
Listeners (TriggerListener, JobListener, SchedulerListener)
Keep Code In Listeners Concise And Efficient
Bạn yêu cuộc sốngPerforming large amounts of work is discouraged, as the thread that would be executing the job (or completing the trigger and moving on to firing another job, etc.) will be tied up within the listener.
Bạn yêu cuộc sốngEvery listener method should contain a try-catch block that handles all possible exceptions.
If a listener throws an exception, it may cause other listeners not to be notified and/or prevent the execution of the job, etc.
Exposing Scheduler Functionality Through Applications
Be Careful of Security!
Some users expose Quartz’s Scheduler functionality through an application user interface. This can be very useful, though it can also be extremely dangerous.
Be sure you don’t mistakenly allow users to define jobs of any type they wish, with whatever parameters they wish. For example, Quartz ships with a pre-made job org.quartz.jobs.NativeJob, which will execute any arbitrary native (operating system) system command that it is defined to. Malicious users could use this to take control of, or destroy your system.
Likewise other jobs such as SendEmailJob, and virtually any others could be used for malicious intent.
|Allowing users to define whatever job they want effectively opens your system to all sorts of vulnerabilities comparable/equivalent to as defined by OWASP and MITRE.|