Apache Camel 4.x Upgrade Guide
This document is for helping you upgrade your Apache Camel application from Camel 4.x to 4.y. For example, if you are upgrading Camel 4.0 to 4.2, then you should follow the guides from both 4.0 to 4.1 and 4.1 to 4.2.
| The Camel Upgrade Recipes project provides automated assistance for some common migration tasks. Note that manual migration is still required. See the documentation page for details. |
| In this 4.15.0 release the Camel Spring Boot does not support running with JDK 17. This has been fixed for the next 4.16.0 release. |
Upgrading Camel 4.14 to 4.15
Data Formats
The data formats has been refactored to ensure their options are consistent and can be mapped from the DSL to their implementation using reflection-free configurers. A few data formats has therefore changed some option names:
Data Format | Old Name | New Name |
crypto | algorithmParameterRef | algorithmParameterSpec |
crypto | keyRef | key |
crypto | initVectorRef | initVector |
csv | formatRef | format |
csv | formatName | format |
flatpack | parserFactoryRef | parserFactory |
jaxb | namespacePrefixRef | namespacePrefix |
soap | namespacePrefixRef | namespacePrefix |
soap | elementNameStrategyRef | elementNameStrategy |
swiftMx | readConfigRef | readConfig |
swiftMx | writeConfigRef | writeConfig |
xmlSecurity | keyOrTrustStoreParametersRef | keyOrTrustStoreParameters |
And in XML DSL the csv dataformat have changed header from a List<String> to be a single String where the header values are separated by comma. This is more tooling friendly and also how other components and dataformats are configured.
For example:
<csv format="EXCEL" delimiter="|" skipHeaderRecord="true">
<header>orderId</header>
<header>amount</header>
</csv>Should be changed to:
<csv format="EXCEL" delimiter="|" skipHeaderRecord="true" header="orderId,amount"/>Likewise in XML DSL the YAML data format has changed typeFilter from a List> to be a single String where the types values are separated by comma. This is more tooling friendly and also how other components and dataformats are configured.
<yaml id="yaml-type-constructor-strdef" library="SnakeYAML">
<typeFilter value="org.apache.camel.component.snakeyaml.model.TestPojo"/>
<typeFilter value="org.apache.camel.component.snakeyaml.model.Rex.*" type="regexp"/>
</yaml>Should be changed to:
<yaml id="yaml-type-constructor-strdef" library="SnakeYAML"
typeFilter="org.apache.camel.component.snakeyaml.model.TestPojo,org.apache.camel.component.snakeyaml.model.Rex.*"/>Removed the tidyMarkup DataFormat in the DSL as the implementation has been removed in earlier version, but we forgot to remove it from the DSL model.
camel-netty / camel-netty-http
Removed deprecated options keyStoreFile and trustStoreFile. Use keyStoreResource and trustStoreResources instead, and prefix the value with file: as documented.
Camel AI Nested Headers classes
There were a number of nested headers classes in the camel-ai components that have been separated into a standalone Headers class. The original class and the corresponding new class are listed below. For more information, the related issue is CAMEL-22334.
Original Class | New Class |
org.apache.camel.component.langchain4j.chat.LangChain4jChat.Headers | org.apache.camel.component.langchain4j.chat.LangChain4jChatHeaders |
org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddings.Headers | org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders |
org.apache.camel.component.langchain4j.embeddingstore.LangChain4jEmbeddingStore.Headers | org.apache.camel.component.langchain4j.embeddingstore.LangChain4jEmbeddingStoreHeaders |
org.apache.camel.component.milvus.Milvus.Headers | org.apache.camel.component.milvus.MilvusHeaders |
org.apache.camel.component.neo4j.Neo4jConstants.Headers | org.apache.camel.component.neo4j.Neo4jHeaders |
org.apache.camel.component.qdrant.Qdrant.Headers | org.apache.camel.component.qdrant.QdrantHeaders |
org.apache.camel.component.pinecone.PineconeVectorDb.Headers | org.apache.camel.component.pinecone.PineconeVectorDbHeaders |
org.apache.camel.component.weaviate.WeaviateVectorDb.Headers | org.apache.camel.component.weaviate.WeaviateVectorDbHeaders |
org.apache.camel.component.langchain4j.web.search.LangChain4jWebSearchEngine.Headers was empty and has been removed