CronResource

CronResource executes application Work tasks at configured intervals.

Often, applications need to run a task at specific times. The CronResource provides a standard way of doing that. Applications need only create a standard javax.resource.Work task and configure the CronResource. Resin can configure the work task with bean-style configuration.

Task running every 15 minutes

<web-app xmlns="http://caucho.com/ns/resin"> <resource type="com.caucho.resources.CronResource"> <init> <cron>*/15</cron> <work bean-class="example.Work"> <foo>Custom Config</foo> </work> </init> </resource> </web-app>

cron	Specifies the times the task should be run	required
work	Specifies application's work bean	required

The cron specification follows the Unix crontab format. The cron is composed of 5 fields: minutes, hours, day of month, month, and day of week.

Each field specifies a range of times to be executed. The patterns allowed are:

example ranges

range	explanation (using minutes as example)
*	run every minute
*/5	run every 5 minutes
0,5,50	run at :00, :05, :50 every hour
0-4	run at :00, :01, :02, :03, :04
0-30/2	run every 2 minutes for the first half hour

The minutes field is always required, and the hours, days, and months fields are optional.

example times

range	explanation
0 */3	run every 3 hours
15 2 *	run every day at 0215 local time
0 0 */3	run every third day at midnight
15 0 * * 6	run every Saturday at 0015

Copyright © 1998-2003 Caucho Technology, Inc. All rights reserved. Resin® is a registered trademark, and HardCoretm and Quercustm are trademarks of Caucho Technology, Inc.