org.apache.camel.spi

Interface RouteController

All Superinterfaces:

AutoCloseable, CamelContextAware, Service, StaticService

public interface RouteController
extends CamelContextAware, StaticService

Controller for managing the lifecycle of all the Route's.

Method Summary

Modifier and Type	Method and Description
Collection<Route>	getControlledRoutes() Return the list of routes controlled by this controller.
ServiceStatus	getRouteStatus(String routeId) Returns the current status of the given route
boolean	isStartingRoutes() Indicates whether current thread is starting route(s).
void	resumeRoute(String routeId) Resumes the given route if it has been previously suspended If the route does not support suspension the route will be started instead
void	startAllRoutes() Starts all the routes which currently is not started.
void	startRoute(String routeId) Starts the given route if it has been previously stopped
void	stopRoute(String routeId) Stops the given route using ShutdownStrategy.
void	stopRoute(String routeId, long timeout, TimeUnit timeUnit) Stops the given route using ShutdownStrategy with a specified timeout.
boolean	stopRoute(String routeId, long timeout, TimeUnit timeUnit, boolean abortAfterTimeout) Stops the given route using ShutdownStrategy with a specified timeout and optional abortAfterTimeout mode.
void	suspendRoute(String routeId) Suspends the given route using ShutdownStrategy.
void	suspendRoute(String routeId, long timeout, TimeUnit timeUnit) Suspends the given route using ShutdownStrategy with a specified timeout.
default <T extends RouteController> T	unwrap(Class<T> clazz) Access the underlying concrete RouteController implementation.

Methods inherited from interface org.apache.camel.CamelContextAware

getCamelContext, setCamelContext, trySetCamelContext

Methods inherited from interface org.apache.camel.Service

close, init, start, stop

Method Detail

getControlledRoutes

Collection<Route> getControlledRoutes()

Return the list of routes controlled by this controller.

Returns:

the list of controlled routes

startAllRoutes

void startAllRoutes()
             throws Exception

Starts all the routes which currently is not started.

Throws:

Exception - is thrown if a route could not be started for whatever reason

isStartingRoutes

boolean isStartingRoutes()

Indicates whether current thread is starting route(s).

This can be useful to know by LifecycleStrategy or the likes, in case they need to react differently.

Returns:

true if current thread is starting route(s), or false if not.

getRouteStatus

ServiceStatus getRouteStatus(String routeId)

Returns the current status of the given route

Parameters:

routeId - the route id

Returns:

the status for the route

startRoute

void startRoute(String routeId)
         throws Exception

Starts the given route if it has been previously stopped

Parameters:

routeId - the route id

Throws:

Exception - is thrown if the route could not be started for whatever reason

stopRoute

void stopRoute(String routeId)
        throws Exception

Stops the given route using ShutdownStrategy.

Parameters:

routeId - the route id

Throws:

Exception - is thrown if the route could not be stopped for whatever reason

See Also:

suspendRoute(String)

stopRoute

void stopRoute(String routeId,
               long timeout,
               TimeUnit timeUnit)
        throws Exception

Stops the given route using ShutdownStrategy with a specified timeout.

Parameters:

routeId - the route id

timeout - timeout

timeUnit - the unit to use

Throws:

Exception - is thrown if the route could not be stopped for whatever reason

See Also:

suspendRoute(String, long, java.util.concurrent.TimeUnit)

stopRoute

boolean stopRoute(String routeId,
                  long timeout,
                  TimeUnit timeUnit,
                  boolean abortAfterTimeout)
           throws Exception

Stops the given route using ShutdownStrategy with a specified timeout and optional abortAfterTimeout mode.

Parameters:

routeId - the route id

timeout - timeout

timeUnit - the unit to use

abortAfterTimeout - should abort shutdown after timeout

Returns:

true if the route is stopped before the timeout

Throws:

Exception - is thrown if the route could not be stopped for whatever reason

See Also:

suspendRoute(String, long, java.util.concurrent.TimeUnit)

suspendRoute

void suspendRoute(String routeId)
           throws Exception

Suspends the given route using ShutdownStrategy.

Suspending a route is more gently than stopping, as the route consumers will be suspended (if they support) otherwise the consumers will be stopped.

By suspending the route services will be kept running (if possible) and therefore its faster to resume the route.

If the route does not support suspension the route will be stopped instead

Parameters:

routeId - the route id

Throws:

Exception - is thrown if the route could not be suspended for whatever reason

suspendRoute

void suspendRoute(String routeId,
                  long timeout,
                  TimeUnit timeUnit)
           throws Exception

Suspends the given route using ShutdownStrategy with a specified timeout.

Suspending a route is more gently than stopping, as the route consumers will be suspended (if they support) otherwise the consumers will be stopped.

By suspending the route services will be kept running (if possible) and therefore its faster to resume the route.

If the route does not support suspension the route will be stopped instead

Parameters:

routeId - the route id

timeout - timeout

timeUnit - the unit to use

Throws:

Exception - is thrown if the route could not be suspended for whatever reason

resumeRoute

void resumeRoute(String routeId)
          throws Exception

Resumes the given route if it has been previously suspended

If the route does not support suspension the route will be started instead

Parameters:

routeId - the route id

Throws:

Exception - is thrown if the route could not be resumed for whatever reason

unwrap

default <T extends RouteController> T unwrap(Class<T> clazz)

Access the underlying concrete RouteController implementation.

Parameters:

clazz - the proprietary class or interface of the underlying concrete RouteController.

Returns:

an instance of the underlying concrete RouteController as the required type.