org.apache.camel.impl
Class DefaultShutdownStrategy

java.lang.Object
  org.apache.camel.impl.ServiceSupport
      org.apache.camel.impl.DefaultShutdownStrategy

All Implemented Interfaces:

CamelContextAware, Service, ShutdownableService, ShutdownStrategy

public class DefaultShutdownStrategy
extends ServiceSupport
implements ShutdownStrategy, CamelContextAware

Default ShutdownStrategy which uses graceful shutdown.

Graceful shutdown ensures that any inflight and pending messages will be taken into account and it will wait until these exchanges has been completed.

As this strategy will politely wait until all exchanges has been completed it can potential wait for a long time, and hence why a timeout value can be set. When the timeout triggers you can also specify whether the remainder consumers should be shutdown now or ignore.

Will by default use a timeout of 300 seconds (5 minutes) by which it will shutdown now the remaining consumers. This ensures that when shutting down Camel it at some point eventually will shutdown. This behavior can of course be configured using the setTimeout(long) and setShutdownNowOnTimeout(boolean) methods.

Routes will by default be shutdown in the reverse order of which they where started. You can customize this using the setShutdownRoutesInReverseOrder(boolean) method.

Version:

$Revision: 932265 $

Constructor Summary

DefaultShutdownStrategy()

DefaultShutdownStrategy(CamelContext camelContext)

Method Summary

protected void	doShutdown()
protected void	doStart()
protected void	doStop()
CamelContext	getCamelContext() Get the CamelContext
long	getTimeout() Gets the timeout.
TimeUnit	getTimeUnit() Gets the time unit used
boolean	isShutdownNowOnTimeout() Whether to force shutdown of all consumers when a timeout occurred.
boolean	isShutdownRoutesInReverseOrder() Whether to shutdown routes in reverse order than they where started.
void	setCamelContext(CamelContext camelContext) Injects the CamelContext
void	setShutdownNowOnTimeout(boolean shutdownNowOnTimeout) Sets whether to force shutdown of all consumers when a timeout occurred and thus not all consumers was shutdown within that period.
void	setShutdownRoutesInReverseOrder(boolean shutdownRoutesInReverseOrder) Sets whether routes should be shutdown in reverse or the same order as they where started.
void	setTimeout(long timeout) Set an timeout to wait for the shutdown to complete.
void	setTimeUnit(TimeUnit timeUnit) Set the time unit to use
void	shutdown(CamelContext context, List<RouteStartupOrder> routes) Shutdown the routes
void	shutdown(CamelContext context, List<RouteStartupOrder> routes, long timeout, TimeUnit timeUnit) Shutdown the routes using a specified timeout instead of the default timeout values
protected void	shutdownNow(Consumer consumer) Shutdown the consumer immediately.
protected void	shutdownNow(List<Consumer> consumers) Shutdown all the consumers immediately.
protected void	shutdownRoutesNow(List<RouteStartupOrder> routes) Shutdown all the consumers immediately.
protected void	suspendNow(SuspendableService service, Consumer consumer) Suspends the consumer immediately.

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

addChildService, getStatus, getVersion, isRunAllowed, isStarted, isStarting, isStopped, isStopping, removeChildService, shutdown, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.camel.Service

start, stop

Constructor Detail

DefaultShutdownStrategy

public DefaultShutdownStrategy()

DefaultShutdownStrategy

public DefaultShutdownStrategy(CamelContext camelContext)

Method Detail

shutdown

public void shutdown(CamelContext context,
                     List<RouteStartupOrder> routes)
              throws Exception

Description copied from interface: ShutdownStrategy

Shutdown the routes

Specified by:

shutdown in interface ShutdownStrategy

Parameters:

context - the camel context

routes - the routes, ordered by the order they was started

Throws:

Exception - is thrown if error shutting down the consumers, however its preferred to avoid this

shutdown

public void shutdown(CamelContext context,
                     List<RouteStartupOrder> routes,
                     long timeout,
                     TimeUnit timeUnit)
              throws Exception

Description copied from interface: ShutdownStrategy

Shutdown the routes using a specified timeout instead of the default timeout values

Specified by:

shutdown in interface ShutdownStrategy

Parameters:

context - the camel context

routes - the routes, ordered by the order they was started

timeout - timeout

timeUnit - the unit to use

Throws:

Exception - is thrown if error shutting down the consumers, however its preferred to avoid this

setTimeout

public void setTimeout(long timeout)

Description copied from interface: ShutdownStrategy

Set an timeout to wait for the shutdown to complete.

Setting a value of 0 or negative will disable timeout and wait until complete (potential blocking forever)

Specified by:

setTimeout in interface ShutdownStrategy

Parameters:

timeout - timeout

getTimeout

public long getTimeout()

Description copied from interface: ShutdownStrategy

Gets the timeout.

Use 0 or a negative value to disable timeout

Specified by:

getTimeout in interface ShutdownStrategy

Returns:

the timeout

setTimeUnit

public void setTimeUnit(TimeUnit timeUnit)

Description copied from interface: ShutdownStrategy

Set the time unit to use

Specified by:

setTimeUnit in interface ShutdownStrategy

Parameters:

timeUnit - the unit to use

getTimeUnit

public TimeUnit getTimeUnit()

Description copied from interface: ShutdownStrategy

Gets the time unit used

Specified by:

getTimeUnit in interface ShutdownStrategy

Returns:

the time unit

setShutdownNowOnTimeout

public void setShutdownNowOnTimeout(boolean shutdownNowOnTimeout)

Description copied from interface: ShutdownStrategy

Sets whether to force shutdown of all consumers when a timeout occurred and thus not all consumers was shutdown within that period.

You should have good reasons to set this option to false as it means that the routes keep running and is halted abruptly when CamelContext has been shutdown.

Specified by:

setShutdownNowOnTimeout in interface ShutdownStrategy

Parameters:

shutdownNowOnTimeout - true to force shutdown, false to leave them running

isShutdownNowOnTimeout

public boolean isShutdownNowOnTimeout()

Description copied from interface: ShutdownStrategy

Whether to force shutdown of all consumers when a timeout occurred.

Specified by:

isShutdownNowOnTimeout in interface ShutdownStrategy

Returns:

force shutdown or not

isShutdownRoutesInReverseOrder

public boolean isShutdownRoutesInReverseOrder()

Description copied from interface: ShutdownStrategy

Whether to shutdown routes in reverse order than they where started.

This option is by default set to true.

Specified by:

isShutdownRoutesInReverseOrder in interface ShutdownStrategy

Returns:

true if routes should be shutdown in reverse order.

setShutdownRoutesInReverseOrder

public void setShutdownRoutesInReverseOrder(boolean shutdownRoutesInReverseOrder)

Description copied from interface: ShutdownStrategy

Sets whether routes should be shutdown in reverse or the same order as they where started.

Specified by:

setShutdownRoutesInReverseOrder in interface ShutdownStrategy

Parameters:

shutdownRoutesInReverseOrder - true to shutdown in reverse order

getCamelContext

public CamelContext getCamelContext()

Description copied from interface: CamelContextAware

Get the CamelContext

Specified by:

getCamelContext in interface CamelContextAware

Returns:

camelContext the Camel context

setCamelContext

public void setCamelContext(CamelContext camelContext)

Description copied from interface: CamelContextAware

Injects the CamelContext

Specified by:

setCamelContext in interface CamelContextAware

Parameters:

camelContext - the Camel context

shutdownRoutesNow

protected void shutdownRoutesNow(List<RouteStartupOrder> routes)

Shutdown all the consumers immediately.

Parameters:

routes - the routes to shutdown

shutdownNow

protected void shutdownNow(List<Consumer> consumers)

Shutdown all the consumers immediately.

Parameters:

consumers - the consumers to shutdown

shutdownNow

protected void shutdownNow(Consumer consumer)

Shutdown the consumer immediately.

Parameters:

consumer - the consumer to shutdown

suspendNow

protected void suspendNow(SuspendableService service,
                          Consumer consumer)

Suspends the consumer immediately.

Parameters:

service - the suspendable consumer

consumer - the consumer to suspend

doStart

protected void doStart()
                throws Exception

Specified by:

doStart in class ServiceSupport

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Specified by:

doStop in class ServiceSupport

Throws:

Exception

doShutdown

protected void doShutdown()
                   throws Exception

Overrides:

doShutdown in class ServiceSupport

Throws:

Exception