Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Annotation Type Elements

Deprecated Interfaces

Interface and Description
org.apache.camel.spi.ExecutorServiceStrategy use ExecutorServiceManager instead, will be removed in a future Camel release
org.apache.camel.spi.ManagementAware will be removed in Camel 3.0. Instead use Spring JMX annotations, see this FAQ entry
org.apache.camel.processor.Traceable

Deprecated Classes

Class and Description
org.apache.camel.model.AOPDefinition will be removed in the future. You can for example use Processor and InterceptStrategy to do AOP in Camel.
org.apache.camel.processor.BatchProcessor may be removed in the future when we overhaul the resequencer EIP
org.apache.camel.processor.CamelLogger This class has been split up into org.apache.camel.util.CamelLogger and org.apache.camel.processor.CamelLogProcessor
org.apache.camel.component.seda.CollectionProducer will be removed in a future Camel release
org.apache.camel.impl.DefaultExecutorServiceStrategy use ExecutorServiceManager instead, will be removed in a future Camel release
org.apache.camel.management.EventNotifierSupport use org.apache.camel.support.EventNotifierSupport instead
org.apache.camel.impl.ExpressionAdapter
org.apache.camel.impl.ExpressionSupport
org.apache.camel.impl.converter.LazyLoadingTypeConverter will be removed in a future Camel release.
org.apache.camel.Main use org.apache.camel.main.Main instead
org.apache.camel.impl.MainSupport
org.apache.camel.impl.converter.PropertyEditorTypeConverter should be removed as it can cause side-effects when using 3rd party property editors
org.apache.camel.impl.ServiceSupport use org.apache.camel.support.ServiceSupport instead
org.apache.camel.model.SetOutHeaderDefinition not really needed, will be removed in the future
org.apache.camel.language.simple.SimpleBackwardsCompatibleParser will be removed in Camel 3.0
org.apache.camel.impl.SynchronizationAdapter use org.apache.camel.support.SynchronizationAdapter instead
org.apache.camel.impl.ThreadPoolProfileSupport use ThreadPoolProfile instead, will be removed in a future Camel release
org.apache.camel.support.TokenXMLPairExpressionIterator use TokenXMLExpressionIterator instead.

Deprecated Exceptions

Exceptions and Description
org.apache.camel.InvalidPayloadException will be removed in Camel 3.0

Deprecated Fields

Field and Description
org.apache.camel.converter.jaxp.XmlConverter.DEFAULT_CHARSET_PROPERTY
org.apache.camel.component.properties.PropertiesComponent.PREFIX_TOKEN Use PropertiesComponent.DEFAULT_PREFIX_TOKEN instead.
org.apache.camel.component.seda.SedaProducer.queue Better make use of the SedaEndpoint.getQueue() API which delivers the accurate reference to the queue currently being used.
org.apache.camel.component.properties.PropertiesComponent.SUFFIX_TOKEN Use PropertiesComponent.DEFAULT_SUFFIX_TOKEN instead.

Deprecated Methods

Method and Description
org.apache.camel.CamelContext.addRouteDefinition(RouteDefinition) use ModelCamelContext.addRouteDefinition(org.apache.camel.model.RouteDefinition)
org.apache.camel.CamelContext.addRouteDefinitions(Collection) use ModelCamelContext.addRouteDefinitions(java.util.Collection)
org.apache.camel.builder.RouteBuilder.addRoutes(RoutesBuilder) will be removed in Camel 3.0. Instead use includeRoutes instead.
org.apache.camel.model.RouteDefinition.adviceWith(CamelContext, RouteBuilder)
org.apache.camel.model.ProcessorDefinition.aop() to be removed in the near future. Instead you can use interceptors or processors to do AOP with Camel.
org.apache.camel.builder.BuilderSupport.bean(Class) use BuilderSupport.method(Class) instead
org.apache.camel.builder.BuilderSupport.bean(Class, String) use BuilderSupport.method(Class, String) instead
org.apache.camel.builder.BuilderSupport.bean(Object) use BuilderSupport.method(Object) instead
org.apache.camel.model.BeanDefinition.bean(Object) not in use, will be removed in next Camel release
org.apache.camel.builder.BuilderSupport.bean(Object, String) use BuilderSupport.method(Object, String) instead
org.apache.camel.model.BeanDefinition.beanType(Class) not in use, will be removed in next Camel release
org.apache.camel.api.management.mbean.ManagedBrowsableEndpointMBean.browseMessageAsXml(Integer) use ManagedBrowsableEndpointMBean.browseAllMessagesAsXml(Boolean) instead
org.apache.camel.util.ObjectHelper.close(Closeable, String, Logger) will be removed in Camel 3.0. Instead use IOHelper.close(java.io.Closeable, String, org.slf4j.Logger) instead
org.apache.camel.impl.converter.AsyncProcessorTypeConverter.convert(Processor) use AsyncProcessorConverterHelper.convert(org.apache.camel.Processor) instead
org.apache.camel.util.ExchangeHelper.createExceptionMessage(String, Exchange, Throwable) use org.apache.camel.CamelExchangeException.createExceptionMessage instead
org.apache.camel.Producer.createExchange(Exchange) will be removed in Camel 3.0
org.apache.camel.Endpoint.createExchange(Exchange) will be removed in Camel 3.0
org.apache.camel.Message.createExchangeId() will be removed in Camel 3.0. It is discouraged for messages to create exchange ids
org.apache.camel.util.IOHelper.createIOException(String, Throwable) IOException support nested exception in Java 1.6. Will be removed in Camel 3.0
org.apache.camel.util.IOHelper.createIOException(Throwable) IOException support nested exception in Java 1.6. Will be removed in Camel 3.0
org.apache.camel.converter.jaxp.XmlConverter.createTransfomer() use XmlConverter.createTransformer(), will be removed in Camel 3.0
org.apache.camel.converter.jaxp.StaxConverter.createXMLEventReader(InputStream) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.StaxConverter.createXMLStreamReader(InputStream) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.getCharsetName(Exchange)
org.apache.camel.converter.IOConverter.getCharsetName(Exchange, boolean)
org.apache.camel.impl.DefaultProducerTemplate.getContext() use DefaultProducerTemplate.getCamelContext()
org.apache.camel.impl.DefaultConsumerTemplate.getContext() use DefaultConsumerTemplate.getCamelContext()
org.apache.camel.CamelContext.getDataFormats() use ModelCamelContext.getDataFormats()
org.apache.camel.CamelContext.getErrorHandlerBuilder() The return type will be switched to ErrorHandlerFactory in Camel 3.0
org.apache.camel.CamelContext.getExecutorServiceStrategy() use CamelContext.getExecutorServiceManager()
org.apache.camel.impl.DefaultCamelContext.getExecutorServiceStrategy()
org.apache.camel.util.ExchangeHelper.getMandatoryInBody(Exchange) use Message.getMandatoryBody()
org.apache.camel.util.ExchangeHelper.getMandatoryInBody(Exchange, Class) use Message.getMandatoryBody(Class)
org.apache.camel.util.ExchangeHelper.getMandatoryOutBody(Exchange) use Message.getMandatoryBody()
org.apache.camel.util.ExchangeHelper.getMandatoryOutBody(Exchange, Class) use Message.getMandatoryBody(Class)
org.apache.camel.component.seda.SedaComponent.getOrCreateQueue(String, Integer) use SedaComponent.getOrCreateQueue(String, Integer, Boolean)
org.apache.camel.processor.RedeliveryPolicy.getRedeliverDelay() will be removed in the near future. Instead use RedeliveryPolicy.getRedeliveryDelay()
org.apache.camel.impl.DefaultProducerTemplate.getResolvedEndpoint(String, Class) use CamelContext.getEndpoint(String, Class)
org.apache.camel.CamelContext.getRouteDefinition(String) use ModelCamelContext.getRouteDefinition(String)
org.apache.camel.CamelContext.getRouteDefinitions() use ModelCamelContext.getRouteDefinitions()
org.apache.camel.processor.interceptor.Tracer.getTraceHandler()
org.apache.camel.model.TryDefinition.handled(boolean) will be removed in Camel 3.0. Instead of using handled(false) you can re-throw the exception from a Processor or use the ProcessorDefinition.throwException(Exception)
org.apache.camel.model.CatchDefinition.handled(boolean) will be removed in Camel 3.0. Instead of using handled(false) you can re-throw the exception from a Processor or use the ProcessorDefinition.throwException(Exception)
org.apache.camel.model.TryDefinition.handled(Expression) will be removed in Camel 3.0. Instead of using handled(false) you can re-throw the exception from a Processor or use the ProcessorDefinition.throwException(Exception)
org.apache.camel.model.CatchDefinition.handled(Expression) will be removed in Camel 3.0. Instead of using handled(false) you can re-throw the exception from a Processor or use the ProcessorDefinition.throwException(Exception)
org.apache.camel.model.TryDefinition.handled(Predicate) will be removed in Camel 3.0. Instead of using handled(false) you can re-throw the exception from a Processor or use the ProcessorDefinition.throwException(Exception)
org.apache.camel.model.CatchDefinition.handled(Predicate) will be removed in Camel 3.0. Instead of using handled(false) you can re-throw the exception from a Processor or use the ProcessorDefinition.throwException(Exception)
org.apache.camel.model.ProcessorDefinition.idempotentConsumer(IdempotentRepository) will be removed in Camel 3.0. Instead use any of the other methods
org.apache.camel.model.ProcessorDefinition.inOnly() use ProcessorDefinition.setExchangePattern(org.apache.camel.ExchangePattern) instead
org.apache.camel.model.ProcessorDefinition.inOut() use ProcessorDefinition.setExchangePattern(org.apache.camel.ExchangePattern) instead
org.apache.camel.CamelContext.isLazyLoadTypeConverters() this option is no longer supported, will be removed in a future Camel release.
org.apache.camel.impl.DefaultCamelContext.isLazyLoadTypeConverters()
org.apache.camel.processor.validation.ValidatingProcessor.isUseDom()
org.apache.camel.CamelContext.loadRoutesDefinition(InputStream) use ModelCamelContext.loadRoutesDefinition(java.io.InputStream)
org.apache.camel.spi.Registry.lookup(String) use Registry.lookupByName(String)
org.apache.camel.spi.Registry.lookup(String, Class) use Registry.lookupByNameAndType(String, Class)
org.apache.camel.spi.Registry.lookupByType(Class) use Registry.findByTypeWithName(Class)
org.apache.camel.util.EndpointHelper.matchEndpoint(String, String) use EndpointHelper.matchEndpoint(org.apache.camel.CamelContext, String, String) instead.
org.apache.camel.model.BeanDefinition.method(String) not in use, will be removed in next Camel release
org.apache.camel.model.WireTapDefinition.newExchange(Expression) will be removed in Camel 3.0 Instead use WireTapDefinition.newExchangeBody(org.apache.camel.Expression)
org.apache.camel.processor.exceptionpolicy.ExceptionPolicyKey.newInstance(Class) will be removed in the near future. Use the constructor instead.
org.apache.camel.processor.exceptionpolicy.ExceptionPolicyKey.newInstance(Class, WhenDefinition) will be removed in the near future. Use the constructor instead.
org.apache.camel.converter.IOConverter.normalizeCharset(String)
org.apache.camel.model.ToDefinition.pattern(ExchangePattern) will be removed in the near future. Instead use ProcessorDefinition.inOnly() or ProcessorDefinition.inOut()
org.apache.camel.impl.DefaultComponent.preProcessUri(String)
org.apache.camel.builder.DefaultErrorHandlerBuilder.redeliverDelay(long) will be removed in the near future. Use DefaultErrorHandlerBuilder.redeliveryDelay(long) instead
org.apache.camel.model.OnExceptionDefinition.redeliverDelay(long) will be removed in the near future. Instead use OnExceptionDefinition.redeliveryDelay(String)
org.apache.camel.processor.RedeliveryPolicy.redeliverDelay(long) will be removed in the near future. Instead use RedeliveryPolicy.redeliveryDelay(long) instead
org.apache.camel.model.BeanDefinition.ref(String) not in use, will be removed in next Camel release
org.apache.camel.builder.ProcessorBuilder.removeFaultHeader(String) will be removed in the near future. Instead use ProcessorBuilder.removeHeader(String)
org.apache.camel.model.ProcessorDefinition.removeFaultHeader(String) will be removed in the near future. Instead use ProcessorDefinition.removeHeader(String)
org.apache.camel.CamelContext.removeRouteDefinition(RouteDefinition) use ModelCamelContext.removeRouteDefinition(org.apache.camel.model.RouteDefinition)
org.apache.camel.CamelContext.removeRouteDefinitions(Collection) use ModelCamelContext.removeRouteDefinitions(java.util.Collection)
org.apache.camel.CamelContext.resolveDataFormatDefinition(String) use ModelCamelContext.resolveDataFormatDefinition(String)
org.apache.camel.model.ProcessorDefinition.routingSlip(String) prefer to use ProcessorDefinition.routingSlip(org.apache.camel.Expression) instead
org.apache.camel.model.ProcessorDefinition.routingSlip(String, boolean) prefer to use ProcessorDefinition.routingSlip() instead
org.apache.camel.model.ProcessorDefinition.routingSlip(String, String) prefer to use ProcessorDefinition.routingSlip(org.apache.camel.Expression, String) instead
org.apache.camel.model.ProcessorDefinition.routingSlip(String, String, boolean) prefer to use ProcessorDefinition.routingSlip() instead
org.apache.camel.builder.DataFormatClause.secureXML(String, boolean, String, String, String)
org.apache.camel.util.ValueHolder.set(V) should be immutable, will be removed in Camel 3.0
org.apache.camel.spi.PackageScanClassResolver.setClassLoaders(Set) will be removed in Camel 3.0. Use PackageScanClassResolver.addClassLoader(ClassLoader) instead.
org.apache.camel.builder.BuilderSupport.setContext(CamelContext)
org.apache.camel.CamelContext.setDataFormats(Map) use ModelCamelContext.setDataFormats(java.util.Map)
org.apache.camel.model.ProcessorDefinition.setFaultHeader(String, Expression) use ProcessorDefinition.setHeader(String, org.apache.camel.Expression)
org.apache.camel.CamelContext.setLazyLoadTypeConverters(Boolean) this option is no longer supported, will be removed in a future Camel release.
org.apache.camel.impl.DefaultCamelContext.setLazyLoadTypeConverters(Boolean)
org.apache.camel.builder.ProcessorBuilder.setOutBody(Expression) use ProcessorBuilder.setBody(org.apache.camel.Expression)
org.apache.camel.model.ProcessorDefinition.setOutHeader(String) use ProcessorDefinition.setHeader(String)
org.apache.camel.builder.ProcessorBuilder.setOutHeader(String, Expression) use ProcessorBuilder.setHeader(String, org.apache.camel.Expression)
org.apache.camel.model.ProcessorDefinition.setOutHeader(String, Expression) use ProcessorDefinition.setHeader(String, org.apache.camel.Expression)
org.apache.camel.processor.RedeliveryPolicy.setRedeliverDelay(long) will be removed in the near future. Instead use RedeliveryPolicy.setRedeliveryDelay(long)
org.apache.camel.impl.DefaultCamelContext.setRoutes(List)
org.apache.camel.processor.interceptor.Tracer.setTraceHandler(TraceEventHandler)
org.apache.camel.processor.interceptor.TraceInterceptor.setTraceHandler(TraceEventHandler)
org.apache.camel.processor.validation.ValidatingProcessor.setUseDom(boolean)
org.apache.camel.api.management.mbean.ManagedRouteMBean.shutdown() will be removed in the near future. Use stop and remove instead
org.apache.camel.api.management.mbean.ManagedRouteMBean.shutdown(long) will be removed in the near future. Use stop and remove instead
org.apache.camel.CamelContext.shutdownRoute(String) use CamelContext.stopRoute(String) and CamelContext.removeRoute(String)
org.apache.camel.CamelContext.shutdownRoute(String, long, TimeUnit) use CamelContext.stopRoute(String, long, java.util.concurrent.TimeUnit) and CamelContext.removeRoute(String)
org.apache.camel.impl.DefaultInflightRepository.size(Endpoint)
org.apache.camel.spi.InflightRepository.size(Endpoint) will be removed in a future Camel release.
org.apache.camel.CamelContext.startRoute(RouteDefinition) use ModelCamelContext.startRoute(org.apache.camel.model.RouteDefinition)
org.apache.camel.model.ModelCamelContext.startRoute(RouteDefinition) favor using CamelContext.startRoute(String)
org.apache.camel.CamelContext.stopRoute(RouteDefinition) use ModelCamelContext.stopRoute(org.apache.camel.model.RouteDefinition)
org.apache.camel.model.ModelCamelContext.stopRoute(RouteDefinition) favor using CamelContext.stopRoute(String)
org.apache.camel.converter.IOConverter.toByteArray(BufferedReader) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toByteArray(Reader) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toByteArray(String) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toInputStream(BufferedReader) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toInputStream(Document) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toInputStream(DOMSource) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toInputStream(String) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toReader(File) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toReader(InputStream) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toReaderFromSource(Source) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toSAXSource(InputStream) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toSAXSource(Source) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toSAXSource(String) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toSAXSourceFromDOM(DOMSource) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toSource(Document) use toDOMSource instead
org.apache.camel.converter.jaxp.XmlConverter.toSource(Node) use toDOMSource instead
org.apache.camel.converter.jaxp.XmlConverter.toStreamSource(Source) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toStreamSourceFromDOM(DOMSource) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toStreamSourceFromSAX(SAXSource) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toString(byte[]) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toString(ByteArrayOutputStream) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toString(File) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toString(InputStream) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toString(Node) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.jaxp.XmlConverter.toString(Source) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toString(URL) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toWriter(File) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.converter.IOConverter.toWriter(OutputStream) will be removed in Camel 3.0. Use the method which has 2 parameters.
org.apache.camel.model.OnExceptionDefinition.useOriginalBody() this method will be removed in Camel 3.0, please use OnExceptionDefinition.useOriginalMessage()
org.apache.camel.converter.IOConverter.validateCharset(String)
org.apache.camel.model.ProcessorDefinition.wireTap(String, boolean, Expression) use the fluent builder from WireTapDefinition, will be removed in Camel 3.0
org.apache.camel.model.ProcessorDefinition.wireTap(String, boolean, Processor) use the fluent builder from WireTapDefinition, will be removed in Camel 3.0
org.apache.camel.model.ProcessorDefinition.wireTap(String, ExecutorService) use the fluent builder from WireTapDefinition, will be removed in Camel 3.0
org.apache.camel.model.ProcessorDefinition.wireTap(String, Expression) use the fluent builder from WireTapDefinition, will be removed in Camel 3.0
org.apache.camel.model.ProcessorDefinition.wireTap(String, Processor) use the fluent builder from WireTapDefinition, will be removed in Camel 3.0
org.apache.camel.model.ProcessorDefinition.wireTap(String, String) use the fluent builder from WireTapDefinition, will be removed in Camel 3.0

Deprecated Constructors

Constructor and Description
org.apache.camel.component.dataset.DataSetEndpoint()
org.apache.camel.impl.DefaultEndpoint(String)
org.apache.camel.impl.DefaultEndpoint(String, CamelContext)
org.apache.camel.impl.DefaultPollingEndpoint(String)
org.apache.camel.impl.DefaultPollingEndpoint(String, CamelContext)
org.apache.camel.processor.exceptionpolicy.ExceptionPolicyKey(Class, WhenDefinition) will be removed in the near future, use the other constructor
org.apache.camel.impl.converter.InstanceMethodFallbackTypeConverter(CachingInjector, Method, TypeConverterRegistry)
org.apache.camel.impl.converter.InstanceMethodTypeConverter(CachingInjector, Method, TypeConverterRegistry)
org.apache.camel.management.ManagedManagementStrategy(ManagementAgent)
org.apache.camel.component.mock.MockEndpoint(String)
org.apache.camel.impl.ProcessorEndpoint(String, Processor)
org.apache.camel.impl.ScheduledPollEndpoint(String)
org.apache.camel.impl.ScheduledPollEndpoint(String, CamelContext)
org.apache.camel.component.seda.SedaProducer(SedaEndpoint, BlockingQueue, WaitForTaskToComplete, long) Use the other constructor.
org.apache.camel.component.seda.SedaProducer(SedaEndpoint, BlockingQueue, WaitForTaskToComplete, long, boolean) Use the other constructor.
org.apache.camel.language.simple.SimpleExpressionParser(String)
org.apache.camel.language.simple.SimplePredicateParser(String)
org.apache.camel.impl.converter.StaticMethodFallbackTypeConverter(Method, TypeConverterRegistry)
org.apache.camel.impl.converter.StaticMethodTypeConverter(Method)
org.apache.camel.util.ValueHolder() should be immutable, will be removed in Camel 3.0
org.apache.camel.model.dataformat.XMLSecurityDataFormat(String, boolean, String, String, String) use {XMLSecurityDataFormat.XMLSecurityDataFormat(String, boolean, String, String, String, String) or {XMLSecurityDataFormat.XMLSecurityDataFormat(String, boolean, String, String, String, KeyStoreParameters) instead
org.apache.camel.model.dataformat.XMLSecurityDataFormat(String, Map, boolean, String, String, String) use {XMLSecurityDataFormat.XMLSecurityDataFormat(String, Map, boolean, String, String, String, String) or {XMLSecurityDataFormat.XMLSecurityDataFormat(String, Map, boolean, String, String, String, KeyStoreParameters) instead

Deprecated Annotation Type Elements

Annotation Type Element and Description
org.apache.camel.RecipientList.shareUnitOfWork