org.apache.camel.component.quartz2

Class QuartzComponent

java.lang.Object

org.apache.camel.support.ServiceSupport

org.apache.camel.impl.DefaultComponent

org.apache.camel.impl.UriEndpointComponent

org.apache.camel.component.quartz2.QuartzComponent

All Implemented Interfaces:

org.apache.camel.CamelContextAware, org.apache.camel.Component, org.apache.camel.ExtendedStartupListener, org.apache.camel.Service, org.apache.camel.ShutdownableService, org.apache.camel.StartupListener, org.apache.camel.StatefulService, org.apache.camel.SuspendableService

public class QuartzComponent
extends org.apache.camel.impl.UriEndpointComponent
implements org.apache.camel.ExtendedStartupListener

A factory for QuartzEndpoint. This component will hold a Quartz Scheduler that will provide scheduled timer based endpoint that generate a QuartzMessage to a route. Currently it support Cron and Simple trigger scheduling type.

This component uses Quartz 2.x API and provide all the features from "camel-quartz". It has reused some of the code, but mostly has been re-written in attempt to be more easier to maintain, and use Quartz more fully.

Field Summary

Fields inherited from class org.apache.camel.support.ServiceSupport

shutdown, shuttingdown, started, starting, stopped, stopping, suspended, suspending

Constructor Summary

Constructors

Constructor and Description
QuartzComponent()
QuartzComponent(org.apache.camel.CamelContext camelContext)

Method Summary

Modifier and Type	Method and Description
protected org.apache.camel.Endpoint	createEndpoint(String uri, String remaining, Map<String,Object> parameters)
protected String	createInstanceName(Properties prop)
protected void	doStart()
protected void	doStartScheduler()
protected void	doStop()
Properties	getProperties()
String	getPropertiesFile()
org.quartz.Scheduler	getScheduler()
org.quartz.SchedulerFactory	getSchedulerFactory()
int	getStartDelayedSeconds()
boolean	isAutoStartScheduler()
boolean	isClustered() Is the quartz scheduler clustered?
boolean	isEnableJmx()
boolean	isInterruptJobsOnShutdown()
boolean	isPrefixInstanceName()
boolean	isPrefixJobNameWithEndpointId()
void	onCamelContextFullyStarted(org.apache.camel.CamelContext context, boolean alreadyStarted)
void	onCamelContextStarted(org.apache.camel.CamelContext context, boolean alreadyStarted)
void	setAutoStartScheduler(boolean autoStartScheduler) Whether or not the scheduler should be auto started.
void	setEnableJmx(boolean enableJmx) Whether to enable Quartz JMX which allows to manage the Quartz scheduler from JMX.
void	setInterruptJobsOnShutdown(boolean interruptJobsOnShutdown) Whether to interrupt jobs on shutdown which forces the scheduler to shutdown quicker and attempt to interrupt any running jobs.
void	setPrefixInstanceName(boolean prefixInstanceName) Whether to prefix the Quartz Scheduler instance name with the CamelContext name.
void	setPrefixJobNameWithEndpointId(boolean prefixJobNameWithEndpointId) Whether to prefix the quartz job with the endpoint id.
void	setProperties(Properties properties) Properties to configure the Quartz scheduler.
void	setPropertiesFile(String propertiesFile) File name of the properties to load from the classpath
void	setScheduler(org.quartz.Scheduler scheduler) To use the custom configured Quartz scheduler, instead of creating a new Scheduler.
void	setSchedulerFactory(org.quartz.SchedulerFactory schedulerFactory) To use the custom SchedulerFactory which is used to create the Scheduler.
void	setStartDelayedSeconds(int startDelayedSeconds) Seconds to wait before starting the quartz scheduler.

Methods inherited from class org.apache.camel.impl.UriEndpointComponent

createComponentConfiguration, createParameterConfigurationMap, getEndpointClass, getParameterConfigurationMap, populateParameterConfigurationMap, setEndpointClass

Methods inherited from class org.apache.camel.impl.DefaultComponent

afterConfiguration, createConfiguration, createEndpoint, getAndRemoveOrResolveReferenceParameter, getAndRemoveOrResolveReferenceParameter, getAndRemoveParameter, getAndRemoveParameter, getCamelContext, getExtension, getSupportedExtensions, ifStartsWithReturnRemainder, isResolvePropertyPlaceholders, preProcessUri, registerExtension, registerExtension, resolveAndRemoveReferenceListParameter, resolveAndRemoveReferenceListParameter, resolveAndRemoveReferenceParameter, resolveAndRemoveReferenceParameter, setCamelContext, setProperties, setProperties, setResolvePropertyPlaceholders, useIntrospectionOnEndpoint, useRawUri, validateParameters, validateURI

Methods inherited from class org.apache.camel.support.ServiceSupport

doResume, doShutdown, doSuspend, getStatus, getVersion, isRunAllowed, isStarted, isStarting, isStopped, isStopping, isStoppingOrStopped, isSuspended, isSuspending, isSuspendingOrSuspended, resume, shutdown, start, stop, suspend

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

QuartzComponent

public QuartzComponent()

QuartzComponent

public QuartzComponent(org.apache.camel.CamelContext camelContext)

Method Detail

isAutoStartScheduler

public boolean isAutoStartScheduler()

setAutoStartScheduler

public void setAutoStartScheduler(boolean autoStartScheduler)

Whether or not the scheduler should be auto started.

This options is default true

getStartDelayedSeconds

public int getStartDelayedSeconds()

setStartDelayedSeconds

public void setStartDelayedSeconds(int startDelayedSeconds)

Seconds to wait before starting the quartz scheduler.

isPrefixJobNameWithEndpointId

public boolean isPrefixJobNameWithEndpointId()

setPrefixJobNameWithEndpointId

public void setPrefixJobNameWithEndpointId(boolean prefixJobNameWithEndpointId)

Whether to prefix the quartz job with the endpoint id.

This option is default false.

isEnableJmx

public boolean isEnableJmx()

setEnableJmx

public void setEnableJmx(boolean enableJmx)

Whether to enable Quartz JMX which allows to manage the Quartz scheduler from JMX.

This options is default true

getProperties

public Properties getProperties()

setProperties

public void setProperties(Properties properties)

Properties to configure the Quartz scheduler.

getPropertiesFile

public String getPropertiesFile()

setPropertiesFile

public void setPropertiesFile(String propertiesFile)

File name of the properties to load from the classpath

isPrefixInstanceName

public boolean isPrefixInstanceName()

setPrefixInstanceName

public void setPrefixInstanceName(boolean prefixInstanceName)

Whether to prefix the Quartz Scheduler instance name with the CamelContext name.

This is enabled by default, to let each CamelContext use its own Quartz scheduler instance by default. You can set this option to false to reuse Quartz scheduler instances between multiple CamelContext's.

isInterruptJobsOnShutdown

public boolean isInterruptJobsOnShutdown()

setInterruptJobsOnShutdown

public void setInterruptJobsOnShutdown(boolean interruptJobsOnShutdown)

Whether to interrupt jobs on shutdown which forces the scheduler to shutdown quicker and attempt to interrupt any running jobs. If this is enabled then any running jobs can fail due to being interrupted.

getSchedulerFactory

public org.quartz.SchedulerFactory getSchedulerFactory()
                                                throws org.quartz.SchedulerException

Throws:

org.quartz.SchedulerException

createInstanceName

protected String createInstanceName(Properties prop)

isClustered

public boolean isClustered()
                    throws org.quartz.SchedulerException

Is the quartz scheduler clustered?

Throws:

org.quartz.SchedulerException

setSchedulerFactory

public void setSchedulerFactory(org.quartz.SchedulerFactory schedulerFactory)

To use the custom SchedulerFactory which is used to create the Scheduler.

getScheduler

public org.quartz.Scheduler getScheduler()

setScheduler

public void setScheduler(org.quartz.Scheduler scheduler)

To use the custom configured Quartz scheduler, instead of creating a new Scheduler.

createEndpoint

protected org.apache.camel.Endpoint createEndpoint(String uri,
                                                   String remaining,
                                                   Map<String,Object> parameters)
                                            throws Exception

Specified by:

createEndpoint in class org.apache.camel.impl.DefaultComponent

Throws:

Exception

doStart

protected void doStart()
                throws Exception

Overrides:

doStart in class org.apache.camel.impl.DefaultComponent

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Overrides:

doStop in class org.apache.camel.impl.DefaultComponent

Throws:

Exception

onCamelContextStarted

public void onCamelContextStarted(org.apache.camel.CamelContext context,
                                  boolean alreadyStarted)
                           throws Exception

Specified by:

onCamelContextStarted in interface org.apache.camel.StartupListener

Throws:

Exception

onCamelContextFullyStarted

public void onCamelContextFullyStarted(org.apache.camel.CamelContext context,
                                       boolean alreadyStarted)
                                throws Exception

Specified by:

onCamelContextFullyStarted in interface org.apache.camel.ExtendedStartupListener

Throws:

Exception

doStartScheduler

protected void doStartScheduler()
                         throws Exception

Throws:

Exception