spring-framework

Spring Framework

Chris Beams 53673d6c59 Support initial delay attribute for scheduled tasks java.util.concurrent's ScheduledExecutorService and its #schedule* methods allow for an 'initialDelay' parameter in milliseconds. Similarly, Spring's TaskExecutor abstraction allows for a concrete 'startTime' expressed as a Date. However, Spring's <task:scheduled> XML element and @Scheduled annotation have, to date, not allowed for an initial delay parameter that can be propagated down to the underlying TaskScheduler/ScheduledExecutorService. This commit introduces initial-delay and #initialDelay attributes to task:scheduled and @Scheduled respectively, both indicating the number of milliseconds to wait before the first invocation of the method in question. Specifying a delay in this fashion is only valid in conjunction with fixed-rate and fixed-delay tasks (i.e. not with cron or trigger tasks). The principal changes required to support these new attributes lie in ScheduledTaskRegistrar, which previously supported registration of tasks in the form of a Runnable and a Long parameter indicating (in the case of fixed-rate and fixed-delay tasks), the interval with which the task should be executed. In order to accommodate a third (and optional) 'initialDelay' parameter, the IntervalTask class has been added as a holder for the Runnable to be executed, the interval in which to run it, and the optional initial delay. For symmetry, a TriggerTask and CronTask have also been added, the latter subclassing the former. And a 'Task' class has been added as a common ancestor for all the above. One oddity of the implementation is in the naming of the new setters in ScheduledTaskRegistrar. Prior to this commit, the setters were named #setFixedDelayTasks, #setFixedRateTasks, etc, each accepting a Map<Runnable, long>. In adding new setters for each task type, each accepting a List<IntervalTask>, List<CronTask> etc, naturally the approach would be to use method overloading and to introduce methods of the same name but with differing parameter types. Unfortunately however, Spring does not support injection against overloaded methods (due to fundamental limitations of the underlying JDK Introspector). This is not a problem when working with the ScheduledTaskRegistrar directly, e.g. from within a @Configuration class that implements SchedulingConfigurer, but is a problem from the point of view of the ScheduledTasksBeanDefinitionParser which parses the <task:scheduled> element - here the ScheduledTaskRegistrar is treated as a Spring bean and is thus subject to these limitations. The solution to this problem was simply to avoid overloading altogether, thus the naming of the new methods ending in "List", e.g. #setFixedDelayTasksList, etc. These methods exist primarily for use by the BeanDefinitionParser and are not really intended for use by application developers. The Javadoc for each of the new methods makes note of this. Issue: SPR-7022		14 years ago
..
images	Move reference docs => src/reference	14 years ago
aop-api.xml	Upgrade reference docs to DocBook 5	14 years ago
aop.xml	Fix typos in Reference Documentation	14 years ago
beans-annotation-config.xml	Fix minor problems and polish reference docs	14 years ago
beans-classpath-scanning.xml	Fix typos in Reference Documentation	14 years ago
beans-context-additional.xml	Add missing section ids in reference documentation	14 years ago
beans-customizing.xml	Remove <emphasis> to work around DocBook bug	14 years ago
beans-dependencies.xml	Add missing section ids in reference documentation	14 years ago
beans-extension-points.xml	Sync with 3.1.x	14 years ago
beans-java.xml	Upgrade reference docs to DocBook 5	14 years ago
beans-scopes.xml	Remove note on singleton-scoped proxy raising BCE	14 years ago
beans-standard-annotations.xml	Fix minor problems and polish reference docs	14 years ago
beans.xml	Fix typos in Reference Documentation	14 years ago
cache.xml	Fix typos in Reference Documentation	14 years ago
cci.xml	Upgrade reference docs to DocBook 5	14 years ago
classic-aop-spring.xml	Fix typos in Reference Documentation	14 years ago
classic-spring.xml	Add missing section ids in reference documentation	14 years ago
dao.xml	Fix minor problems and polish reference docs	14 years ago
dtd.xml	Upgrade reference docs to DocBook 5	14 years ago
dynamic-languages.xml	Upgrade reference docs to DocBook 5	14 years ago
ejb.xml	Upgrade reference docs to DocBook 5	14 years ago
expressions.xml	Fix typo in section id	14 years ago
index.xml	Fix minor problems and polish reference docs	14 years ago
jdbc.xml	Add missing section ids in reference documentation	14 years ago
jms.xml	Add missing section ids in reference documentation	14 years ago
jmx.xml	Upgrade reference docs to DocBook 5	14 years ago
mail.xml	Upgrade reference docs to DocBook 5	14 years ago
mvc.xml	Add missing section ids in reference documentation	14 years ago
new-in-3.0.xml	Add missing section ids in reference documentation	14 years ago
new-in-3.1.xml	Add missing section ids in reference documentation	14 years ago
orm.xml	Upgrade reference docs to DocBook 5	14 years ago
overview.xml	Add missing section ids in reference documentation	14 years ago
oxm.xml	Add missing section ids in reference documentation	14 years ago
portlet.xml	Fix typos in Reference Documentation	14 years ago
preface.xml	Fix minor problems and polish reference docs	14 years ago
remoting.xml	Add missing section ids in reference documentation	14 years ago
resources.xml	Fix typos in Reference Documentation	14 years ago
scheduling.xml	Support initial delay attribute for scheduled tasks	14 years ago
spring-form.tld.xml	Fix minor problems and polish reference docs	14 years ago
spring.tld.xml	Fix typo in spring:eval taglib reference doc	14 years ago
swf-sidebar.xml	Remove <emphasis> to work around DocBook bug	14 years ago
testing.xml	Doc. usage of JSR-250 lifecycle annotations in TCF	14 years ago
transaction.xml	Add missing section ids in reference documentation	14 years ago
validation.xml	Fix broken link to JavaBean customization tutorial	14 years ago
view.xml	Add Jackson 2 HttpMessageConverter and View	14 years ago
web-integration.xml	Fix typos in Reference Documentation	14 years ago
xml-custom.xml	Fix typos in Reference Documentation	14 years ago
xsd-configuration.xml	Fix typos in Reference Documentation	14 years ago