org.apache.camel.Route Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.camel;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Set;
import org.apache.camel.spi.InterceptStrategy;
import org.apache.camel.spi.ManagementInterceptStrategy;
import org.apache.camel.spi.RouteController;
import org.apache.camel.spi.RouteError;
import org.apache.camel.spi.RoutePolicy;
/**
* A Route
* defines the processing used on an inbound message exchange
* from a specific {@link org.apache.camel.Endpoint} within a {@link org.apache.camel.CamelContext}.
*
* Use the API from {@link org.apache.camel.CamelContext} to control the lifecycle of a route,
* such as starting and stopping using the {@link org.apache.camel.spi.RouteController#startRoute(String)}
* and {@link org.apache.camel.spi.RouteController#stopRoute(String)} methods.
*/
public interface Route extends RuntimeConfiguration {
String ID_PROPERTY = "id";
String CUSTOM_ID_PROPERTY = "customId";
String PARENT_PROPERTY = "parent";
String GROUP_PROPERTY = "group";
String REST_PROPERTY = "rest";
String DESCRIPTION_PROPERTY = "description";
/**
* Gets the route id
*
* @return the route id
*/
String getId();
/**
* Gets the route group
*
* @return the route group
*/
String getGroup();
/**
* Gets the uptime in a human readable format
*
* @return the uptime in days/hours/minutes
*/
String getUptime();
/**
* Gets the uptime in milliseconds
*
* @return the uptime in milliseconds
*/
long getUptimeMillis();
/**
* Gets the inbound {@link Consumer}
*
* @return the inbound consumer
*/
Consumer getConsumer();
/**
* Gets the {@link Processor}
*
* @return the processor
*/
Processor getProcessor();
/**
* Whether or not the route supports suspension (suspend and resume)
*
* @return true if this route supports suspension
*/
boolean supportsSuspension();
/**
* This property map is used to associate information about the route.
*
* @return properties
*/
Map getProperties();
/**
* Gets the route description (if any has been configured).
*
* The description is configured using the {@link #DESCRIPTION_PROPERTY} as key in the {@link #getProperties()}.
*
* @return the description, or null if no description has been configured.
*/
String getDescription();
/**
* Gets the camel context
*
* @return the camel context
*/
CamelContext getCamelContext();
/**
* Gets the input endpoint for this route.
*
* @return the endpoint
*/
Endpoint getEndpoint();
/**
* A strategy callback allowing special initialization when services are starting.
*
* @param services the service
* @throws Exception is thrown in case of error
*/
void onStartingServices(List services) throws Exception;
/**
* Returns the services for this particular route
*
* @return the services
*/
List getServices();
/**
* Adds a service to this route
*
* @param service the service
*/
void addService(Service service);
/**
* Returns a navigator to navigate this route by navigating all the {@link Processor}s.
*
* @return a navigator for {@link Processor}.
*/
Navigate navigate();
/**
* Returns a list of all the {@link Processor}s from this route that has id's matching the pattern
*
* @param pattern the pattern to match by ids
* @return a list of {@link Processor}, is never null.
*/
List filter(String pattern);
/**
* Callback preparing the route to be started, by warming up the route.
*/
void warmUp();
/**
* Gets the last error.
*
* @return the error
*/
RouteError getLastError();
/**
* Sets the last error.
*
* @param error the error
*/
void setLastError(RouteError error);
Integer getStartupOrder();
void setStartupOrder(Integer startupOrder);
/**
* Gets the {@link RouteController} for this route.
*
* @return the route controller,
*/
RouteController getRouteController();
/**
* Sets the {@link RouteController} for this route.
*
* @param controller the RouteController
*/
void setRouteController(RouteController controller);
/**
* Sets whether the route should automatically start when Camel starts.
*
* Default is true to always start up.
*
* @param autoStartup whether to start up automatically.
*/
void setAutoStartup(Boolean autoStartup);
/**
* Gets whether the route should automatically start when Camel starts.
*
* Default is true to always start up.
*
* @return true if route should automatically start
*/
Boolean isAutoStartup();
/**
* Gets the route id
*/
String getRouteId();
/**
* Gets the route description
*/
String getRouteDescription();
/**
* Get the route type
*
* @return the route type
*/
NamedNode getRoute();
//
// CREATION TIME
//
/**
* This method retrieves the event driven Processors on this route context.
*/
List getEventDrivenProcessors();
/**
* This method retrieves the InterceptStrategy instances this route context.
*
* @return the strategy
*/
List getInterceptStrategies();
/**
* Sets a special intercept strategy for management.
*
* Is by default used to correlate managed performance counters with processors
* when the runtime route is being constructed
*
* @param interceptStrategy the managed intercept strategy
*/
void setManagementInterceptStrategy(ManagementInterceptStrategy interceptStrategy);
/**
* Gets the special managed intercept strategy if any
*
* @return the managed intercept strategy, or null if not managed
*/
ManagementInterceptStrategy getManagementInterceptStrategy();
/**
* Gets the route policy List
*
* @return the route policy list if any
*/
List getRoutePolicyList();
void setErrorHandlerFactory(ErrorHandlerFactory errorHandlerFactory);
ErrorHandlerFactory getErrorHandlerFactory();
Processor createErrorHandler(Processor processor) throws Exception;
Collection getOnCompletions();
// called at runtime
Processor getOnCompletion(String onCompletionId);
// called at completion time
void setOnCompletion(String onCompletionId, Processor processor);
Collection getOnExceptions();
Processor getOnException(String onExceptionId);
void setOnException(String onExceptionId, Processor processor);
/**
* Adds error handler for the given exception type
*
* @param factory the error handler factory
* @param exception the exception to handle
*/
void addErrorHandler(ErrorHandlerFactory factory, NamedNode exception);
/**
* Gets the error handlers
*
* @param factory the error handler factory
*/
Set getErrorHandlers(ErrorHandlerFactory factory);
/**
* Link the error handlers from a factory to another
*
* @param source the source factory
* @param target the target factory
*/
void addErrorHandlerFactoryReference(ErrorHandlerFactory source, ErrorHandlerFactory target);
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy