Apache Camel 3.x Upgrade Guide

This document is for helping you upgrade your Apache Camel application from Camel 3.x to 3.y. For example if you are upgrading Camel 3.0 to 3.2, then you should follow the guides from both 3.0 to 3.1 and 3.1 to 3.2.

Upgrading Camel 3.12 to 3.13

API changes

Added method getStartedEventNotifiers to org.apache.camel.spi.ManagementStrategy.

Added method scheduleQueue to org.apache.camel.spi.ReactiveExecutor.

The org.apache.camel.support.ObjectHelper#createIterable now supports java.util.Map returning an Iterable<Map.Entry> iterating each row in the map.

Split EIP

The Split EIP now supports splitting message bodies that are of type java.util.Map, which now splits that into a Set<Map.Entry> - eg a set of each map entry as key/value pairs.


The org.apache.camel.builder.SimpleBuilder has been deprecated. This builder was mostly used internally in Camel with the Java DSL in some situations.

End users that may use SimpleBuilder in Camel Java DSL can migrate from:



simple("1", Integer.class)

CamelContextInitializing and CamelContextInitialized events

These two events are fired during bootstrap of CamelContext even if a custom EventNotifier may not have been fully started. This is due to that these events happen very early in the bootstrap process, but are of importance for event notifiers to be able to react upon.

Using custom Debugger

Previously when setting a custom org.apache.camel.spi.Debugger, then Camel would automatically enable debug mode. Now debugging must be enabled by setting setDebugging(true) on CamelContext.

Using transactions

The routing engine has been changed to route exchanges in a different order when using transactions (.transacted()). When an Exchange is continued routed a task is scheduled to the ReactiveExecutor. This fixed issues with could lead to StackOverflowException.


The camel-hazelcast-starter for Spring Boot no longer has customer auto configuration options for all its components

eg the following configuration keys have been removed

  • …​customizer.hazelcast-instance.enabled

  • …​customizer.hazelcast-instance.override

Any Camel component can be customized by using the org.apache.camel.spi.ComponentCustomizer SPI.


When using Rest DSL and the restConfiguration has a contextPath configured, then this value is used as leading base path for all API services that are in the generated api-docs.

This is i.e. needed when using camel-servlet which runs under a specific context-path.


In order to reduce memory pressure, the component was modified to avoid using Lists for certain file operations (CAMEL-17059). This affected the APIs of some the APIs and interfaces provided by the component.

  • GenericFileOperations: the return type for the methods listFiles and listFiles(String) was modified to return an array of (generic) objects instead of a List

  • GenericFileConsumer: the signature of the methods isValidFile and isMatched was modified to receive an array of files.


The FtpConsumer, FtpOperations, SftConsumer and SftpOperations classes were modified to comply with the API changes on the camel-file component.


The ScpOperations class were modified to comply with the API changes on the camel-file component.


The KafkaManualCommit class were modified in order to support async manual commit. Please use the new function commit() instead of the old deprecated one commitSync().