Apache camel 3.1.0 Release

New and Noteworthy

This release is the new Camel 3.1.0 major release.

Supported Java version

This version supports Java 8 and 11.

Getting the Binaries using Maven

To use this release in your Apache Maven pom.xml, import the Camel Bill of Materials (BOM) and then include the camel-core and any other components needed without specifying the version.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.apache.camel</groupId>
      <artifactId>camel-bom</artifactId>
      <version>3.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-core</artifactId>
  </dependency>
  <dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-COMPONENT</artifactId>
  </dependency>
</dependencies>

To use this release in a Spring Boot application, use the camel-spring-boot-dependencies Bill of Materials (BOM):

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.apache.camel.springboot</groupId>
      <artifactId>camel-spring-boot-dependencies</artifactId>
      <version>3.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>org.apache.camel.springboot</groupId>
    <artifactId>camel-COMPONENT-starter</artifactId>
  </dependency>
</dependencies>

Apache Camel

Download Signature and checksum
apache-camel-3.1.0-src.zip (Sources) PGP Signature, SHA512 Checksum

Git tag checkout

Release is tagged with camel-3.1.0 in the Git, to fetch it use:

git clone https://git-wip-us.apache.org/repos/asf/camel.git
cd camel
git checkout camel-3.1.0

Resolved issues

Here is a list of all the issues that have been resolved for this release

Bug (65)

CAMEL-14594
ProducerServicePool - Memory leak
CAMEL-14593
Eager type converter creation breaks WildFly integration
CAMEL-14591
Recipient List EIP - MemoryLeak
CAMEL-14586
camel-core - Disable cache on some EIPs seems to not be working correlction
CAMEL-14579
Camel-mail: MemoryLeak when sending mails using recipient list or dynamic to
CAMEL-14577
QuartzEndpoint returns no trigger parameters
CAMEL-14561
Camel-Blueprint fails on JDK8 with NPE
CAMEL-14548
resilience4j doesn't catch configuration from spring boot
CAMEL-14534
Wrong message in some cases in org.apache.camel.PropertyBindingException
CAMEL-14529
Pipeline inconsistency due to mutable processors list
CAMEL-14510
NullPointerException with @BeanInject
CAMEL-14506
came-ftp - streamDownload=true and stepwise=true for larger files could cause deadlock
CAMEL-14503
camel-package-maven-plugin:generate fails with NPE for component outside the camel source tree
CAMEL-14492
EtcdKeysEndpoint cannot be cast to AbstractEtcdPollingEndpoint
CAMEL-14462
Camel-Blueprint: Endpoint parameters not recognized
CAMEL-14457
Groovy language: NoClassDefFoundError in OSGi environment
CAMEL-14456
camel-master - RAW() parameter value in delegated URI gets encoded
CAMEL-14453
ensure Camel Rest Swagger example work again
CAMEL-14452
Unable to configure font or page size on PDF endpoints
CAMEL-14449
camel-main: duration properties are ignored
CAMEL-14447
OpenApi V3: ensure all variables are parsed for Server Url
CAMEL-14442
Scheduler no longer shared between routes using the same scheduler name
CAMEL-14441
Stomp connections are not established when the queues have additional features
CAMEL-14439
camel-openapi-java: OasInfo may miss parent pointer
CAMEL-14424
camel-salesforce - HTTP responses over 4 MB fail
CAMEL-14420
Support `KafkaOffsetBackingStore` in camel-debezim
CAMEL-14419
Enrich EIP - Should wrap in UoW
CAMEL-14412
Maven central now requires HTTPS
CAMEL-14396
websocket-jsr356 consumer fails when endpoint URI parameters are provided
CAMEL-14390
websocket-jsr356 producer hangs
CAMEL-14387
camel-salesforce - Null pointer exception when restart client in SubscriptionHelper
CAMEL-14372
Validator component fails with java.lang.IllegalArgumentException: protocol = http host = null
CAMEL-14368
can't gracefully shutdown a camel-undertow consumer endpoint
CAMEL-14366
JUnit declared in compile scope
CAMEL-14363
Camel netty requestTimeout doesn't work as expected
CAMEL-14350
camel-main: xml routes discovery does not work outside the classpath
CAMEL-14340
camel-core - Concurrency issue in multipool for non singleton producers
CAMEL-14333
Camel Jgroups Component doesn't export org.apache.camel.component.jgroups.cluster
CAMEL-14332
camel-blueprint - Camel route does not consider the value of ShutdownStrategy timeout.
CAMEL-14327
Jt400PgmProducer doStop() method called on actively used instance
CAMEL-14323
XMPP room with password disconnect after bootup
CAMEL-14318
camel-blueprint - <proxy> in XSD is anyType
CAMEL-14312
Fix issues reported by lgtm.com
CAMEL-14306
Endpoint DSL - ToD sets hash parameter when using complex objects as parameters
CAMEL-14303
Setting matchOnUriPrefix on netty-http Rest Component causes api route to fail
CAMEL-14302
Camel-spring: No longer possible to invoke static method of non-spring bean
CAMEL-14300
Java 8 Supplier overloadings break all DSLs
CAMEL-14299
camel-sql - Dynamic producer (toD) problem
CAMEL-14277
NPE when NATS server not configured
CAMEL-14272
Configuring endpoint with bean reference should fail if no such bean found
CAMEL-14271
camel di does not work for routes discovered from the registry
CAMEL-14268
Component auto configuration fails in Java 11
CAMEL-14267
Conversion fails with NullPointerException when the body is null at the end of a route and an outputType is set
CAMEL-14265
camel-cdi - Standalone CDI with Camel Main discovers routes twice
CAMEL-14257
allowUseOriginalMessage not configurable
CAMEL-14243
Opentracing with JMS not working when JmsComponent is defined as a Spring bean
CAMEL-14242
camel-rabbitmq - Binding parameters with x- is not possible when using endpointdsl
CAMEL-14241
InfluxDb does not define its dependency on okio
CAMEL-14234
Project generated with camel-archetype-spring-boot cannot be built
CAMEL-14224
Camel-Websocket: The sendToAll method in the Producer is really slow
CAMEL-14223
EndpointBuilderFactory is not updated whenever `:camel-package:generate-endpoint-dsl` is executed
CAMEL-14220
camel-activemq - Setting brokerURL via camel-main issue
CAMEL-14219
ReactiveStreams subscriber does not enforce type conversion
CAMEL-14213
camel-jms - Using XA and having 2 or more connection factories issue
CAMEL-11947
Race condition in iec60870 producer

Improvement (131)

CAMEL-14590
Camel-Pulsar consumer calls unsubscribe on doStop/doSuspend, potentially deleting subscription
CAMEL-14589
camel-cxf - Service beans can only be set via context
CAMEL-14582
camel-bean - Optimize excluded methods
CAMEL-14580
camel-main - Add option to clear reifier when no need to add new routes
CAMEL-14572
camel-core - Optimize type converter for some basic convertions
CAMEL-14571
camel-core - Optimize type converter eager created
CAMEL-14570
camel-zookeeper-master - Use testcontainers for testing
CAMEL-14569
camel-zookeeper - Use test containers for testing
CAMEL-14564
Webhook endpoint may not be fully initialized when the route policy is applied
CAMEL-14563
The camel api generator maven plugin does not support packages correctly
CAMEL-14560
Use a custom xref checker as the antora one is very slow
CAMEL-14559
Use String in definition fields to be able to leverage property placeholders
CAMEL-14546
camel-xmlsecurity - Split up into verify and sign endpoints
CAMEL-14545
Document the Camel Catalog
CAMEL-14538
camel-core - Do not load type converters via package scanning by default
CAMEL-14523
Sort component options correctly
CAMEL-14521
Unicode problem in Bindy component for fixed length data
CAMEL-14517
camel-core - JAXB JARs should be dependencies on camel-xml-jaxb and not globally
CAMEL-14515
camel-core - Include spi annotations in camel-api
CAMEL-14509
camel-package-maven-plugin - generate-component - Make it generate so the code is in the JAR by default
CAMEL-14502
JSR 356 Websocket component does not work properly on Spring Boot
CAMEL-14501
gain fully control of xml parser used by saxon
CAMEL-14500
camel-core - spi-annotations is not optional
CAMEL-14498
camel-core - Make RuntimeCamelCatalog a simpler API
CAMEL-14497
camel-core - Avoid camel-util-json if not needed
CAMEL-14489
camel-core-engine - XML and JAXB should be optional
CAMEL-14487
camel-jaxp - Rename to camel-xml-jaxp
CAMEL-14485
camel-componentdsl - Sort the component in the pom.xml and ComponentsBuilderFactory
CAMEL-14484
ValidateReifier requires camel-jaxp
CAMEL-14483
camel-endpointdsl dependency on camel-jaxp and camel-util-json
CAMEL-14481
camel-spring-boot: Remove camel-management to disable JMX by default
CAMEL-14477
camel-netty - Disable object serialization
CAMEL-14471
camel-spring-boot: Disable proxying of bean methods for auto-configuration classes
CAMEL-14466
camel-core - Optimize reduce error handler memory usage
CAMEL-14461
camel-core - Make RuntimeCatalog optional and in its own module
CAMEL-14460
camel-core - Optimize and allow to turn off case insensitive headers
CAMEL-14438
camel-core - Optimize core for checking for stop routing
CAMEL-14436
CamelContext - Move ReactiveExecutor to ExtendedCamelContext
CAMEL-14435
camel-core - Optimize using reactive executor
CAMEL-14433
Optimize core - Message ID should default to be same as exchangeID
CAMEL-14428
Terminate the JVM for OutOfMemoryError when running tests
CAMEL-14427
camel-core - Optimize UnitOfWork route context push/pop
CAMEL-14426
camel-core - Optimize inflight repository
CAMEL-14425
Mail Consumer Performance Optimization
CAMEL-14422
DefaultShutdownStrategy not masking sensitive information
CAMEL-14421
optimize core - ServiceSupport should not have instance logger
CAMEL-14418
camel-timer - Add option to turn on/off metadata
CAMEL-14416
Camel Pulsar: support subscriptionInitialPosition for consumers
CAMEL-14414
Aggregation completion has inconsistent property/header handling
CAMEL-14411
Avoid using reflection when configuring DataFormats
CAMEL-14409
camel-core - Optimize Exchange
CAMEL-14406
Component configurer - Generate API for returning which properties the component have
CAMEL-14403
Add capability to customize server endpoints created by websocket-jsr356 consumer
CAMEL-14401
Restore default host/port options for IPFS
CAMEL-14399
camel-osgi OsgiDefaultCamelContext does not use JmxManagementStrategyFactory
CAMEL-14398
camel-core - MessageHistory off by default
CAMEL-14397
DefaultComponent should prefer getting the configurers from the registry before checking the FactoryFinder
CAMEL-14393
Components that are DelegateEndpoint need to set some basic options
CAMEL-14392
Components that are consumer only should not have option lazyStartProducer
CAMEL-14389
Make entrypoint for "endpoint dsl" static
CAMEL-14384
camel-jsonpath: Do not use reflection on the annotation proxy in DefaultAnnotationExpressionFactory
CAMEL-14383
camel-core - Bean language add support for declaring type explicit
CAMEL-14380
camel-core - Add hostname function to simple language
CAMEL-14379
camel-core - Route lifecycle should not log full endpoint uris
CAMEL-14377
Add configuration option to disable BraintreeLogHandler
CAMEL-14376
camel-netty-http - Drop servlet dependency
CAMEL-14375
camel-kafka - The saslJaasConfig option may contain sensitive information that can be logged
CAMEL-14374
Camel-irc validation of endpoint's url fails for correct url
CAMEL-14371
Upgrade to velocity 2.1
CAMEL-14367
review netty-all usage
CAMEL-14364
Endpoint DSL - Add default values in javadoc
CAMEL-14361
camel-http - Avoid reflection in creating http method
CAMEL-14359
camel-bean - Let cache be default enabled
CAMEL-14357
camel-bean - Add start/stop to BeanHolder so we can do eager lookup
CAMEL-14356
camel-core - toString of processors should favour just outputting their node id
CAMEL-14355
PDF producer should close PDF documents
CAMEL-14354
camel-core - Optimize unnecessary object allocations
CAMEL-14353
Eager init LRUCacheFactory
CAMEL-14352
Add camel-openapi as api-doc discovered component
CAMEL-14351
camel-rest - Rest producer may detect multiple rest producer factory
CAMEL-14349
camel-core - Transformer and Validator registry should be on-demand
CAMEL-14347
camel-core - Remove default producer/consumer service pool from CamelContext
CAMEL-14346
Camel-CoAP: Add a recommendedCipherSuitesOnly option to the endpoint
CAMEL-14345
camel-core - Optimize SendProcessor to not use ProducerCache when not needed
CAMEL-14344
camel-milo - Upgrade to newer milo version
CAMEL-14342
Add cacheSize option to recipientList EIP
CAMEL-14339
JMX - ManagedProducer - should have routeId
CAMEL-14338
Processor - Add RouteIdAware so EIP processors can know which route they are serving
CAMEL-14336
Default shutdown timeout should be reduced to 45 seconds
CAMEL-14330
camel-aws-lambda - Operation should invoke function by default
CAMEL-14329
Adding component should not autowire singleton from registry in nested mode
CAMEL-14328
camel-aws-lambda - Function should not be configurable on component level
CAMEL-14325
Add new functions on camel-cmis component
CAMEL-14321
camel-osgi-activator Allow RouteBuilders to be added Pre Camel Context Start
CAMEL-14316
Http component - Tests cleanup
CAMEL-14313
Camel-AWS Translate: Add terminology names support
CAMEL-14311
Provide validation for Camel properties files
CAMEL-14309
Include Camel Main in the catalog
CAMEL-14308
Upgrade to Kafka 2.4.x
CAMEL-14307
camel-rabbitmq - unable to set empty routing key when declaring DLX
CAMEL-14292
Remove unwanted dependency to google-http-client library
CAMEL-14288
Endpoint configurer should deal better with list types
CAMEL-14287
getComponent on CamelContext should initialize component
CAMEL-14284
Configuring endpoint should set properties on endpoint and not configuration object
CAMEL-14278
Upgrade to microprofile config 1.5
CAMEL-14275
Camel component option with Properties should be configurable in SB
CAMEL-14273
Configuring endpoint which fails in setter should repot this as property binding exception
CAMEL-14270
[camel-quart2-starter] Can't set properties using application.properties
CAMEL-14266
Add getStartDate to CamelContext api
CAMEL-14263
Generate configurers for types annotated with @UriParams
CAMEL-14253
camel-nats - Configure brokers on component level
CAMEL-14251
camel-nats - Store message payload in body/headers
CAMEL-14250
Allow custom configurations into Kafka component
CAMEL-14247
camel-netty - Turn off component level shared thread pool and use nettys workers directly
CAMEL-14246
Camel-SQL: Relax the modifier for datasource setter by removing final
CAMEL-14245
[camel-main] allow to enable/disable auto confioguiration per component/language/data-format
CAMEL-14240
Add backlogTracing into the spring/blueprint XML
CAMEL-14238
Ensure generated catalog is providing a valid json even if there is no description provided
CAMEL-14233
camel-kafka - topic overriding not possible when using aggregation
CAMEL-14229
STOMP headers are missing in the Exchange
CAMEL-14228
camel-netty - Let netty calculate the default worker count
CAMEL-14154
Add option to create cache if it doesn't exists in camel-infinispan
CAMEL-14074
http - Allow restricted headers
CAMEL-13830
Move examples to a new camel-examples git repo
CAMEL-13575
Use strings instead of boolean/integer/long in definition fields
CAMEL-13213
Cannot use rest-swagger component with swagger.json provided over HTTPS protocol
CAMEL-12962
camel-elasticsearch - Allow from and size for SearchSource / SearchRequest to be set via URI
CAMEL-12219
Camel-Solr: support for soft commit
CAMEL-11833
camel-catalog : provide a catalog model
CAMEL-11727
Upgrade Groovy to version containing Ivy fixes for cache resolution
CAMEL-6950
camel-sjms: Lacks reconnection logic in case of exception

New Feature (25)

CAMEL-14588
MailConsumer: Move mail after processing
CAMEL-14525
provide a bean definition to the auto configuration by property feature
CAMEL-14475
camel-core - Make loading XML pluggable via SPI
CAMEL-14468
Add support for classification in camel-weka
CAMEL-14443
Add new producers to camel-jira
CAMEL-14440
Add Workday report as a service component.
CAMEL-14417
[camel-jslt] Create spring-boot starter for camel-jslt
CAMEL-14400
Add support for Weka Data Mining
CAMEL-14385
Camel-cron component
CAMEL-14360
Allow overriding message key and partition key for aggregated kafka messages
CAMEL-14348
Camel-AWS Lambda: Add alias operations
CAMEL-14315
add openapi-rest-dsl-generator
CAMEL-14301
Stomp Component has no option to set custom headers
CAMEL-14282
came-nsq - Configure servers on component level
CAMEL-14279
Move camel-core-osgi-activator to Components camel-osgi-activator
CAMEL-14252
camel-nats - Add support for reply-to in consumer
CAMEL-14235
camel-seda - Add option to discard if full
CAMEL-14227
camel-rest-swagger - Add support for OpenApi 3.0 spec
CAMEL-14221
Stomp Component has no option to set version
CAMEL-14215
Camel Main for OSGi
CAMEL-14159
camel-elytron - Security component
CAMEL-13903
camel-telegram - use a stock HTTP client instead of the JAX-RS client
CAMEL-13807
Component DSL - To configure components like endpoint DSL
CAMEL-13699
Add Json to Json transformation using JSLT
CAMEL-12619
camel-swagger-java - Add support for 3.0 spec

Sub-task (19)

CAMEL-14553
Create an AWS-SQS component based on SDK v2
CAMEL-14552
Create an AWS-SNS component based on SDK v2
CAMEL-14551
Create an AWS-SES component based on SDK v2
CAMEL-14550
Create an AWS-SDB component based on SDK v2
CAMEL-14519
Create an AWS-DDB component based on SDK v2
CAMEL-14518
Create an AWS-EC2 component based on SDK v2
CAMEL-14508
Create an AWS-CloudWatch component based on SDK v2
CAMEL-14491
Create an AWS-IAM component based on SDK v2
CAMEL-14478
Create an AWS-KMS component based on SDK v2
CAMEL-14476
Able to extend workday component for futher entities support
CAMEL-14464
Create an AWS-MSK component based on SDK v2
CAMEL-14463
Create an AWS-MQ component based on SDK v2
CAMEL-14458
Create an AWS-EKS component based on SDK v2
CAMEL-14446
Create an AWS-ECS component based on SDK v2
CAMEL-14408
Create an AWS-Translate component based on SDK v2
CAMEL-13228
telegram - Games support
CAMEL-13226
telegram - Stickers support
CAMEL-13224
telegram - Inline mode
CAMEL-13223
telegram - Implement methods to update messages

Task (44)

CAMEL-14585
camel-spring-boot - The BOM includes a wrong target artifactId
CAMEL-14558
Execute camel-kafak tests with testcontainers
CAMEL-14549
Remove camel-itest-karaf
CAMEL-14543
Execute camel-etcd tests with testcontainers
CAMEL-14539
camel-spring-boot - Add STARTER markers in doc files
CAMEL-14532
Fix issues with camel-snakeyaml
CAMEL-14530
camel-catalog - Remove html docs
CAMEL-14528
Move camel-spring-boot-* into a core folder
CAMEL-14516
Components should use the endpoint configurer when possible
CAMEL-14513
camel-cdi - Remove OSGi stuff
CAMEL-14507
Enhance components/endpoints configurers to inherit the parent
CAMEL-14505
Remove meta-annotations
CAMEL-14504
camel-apt - No longer used replaced by camel-package-maven-plugin
CAMEL-14474
Dead link in "Message Exchange" doc to "Exchange" doc
CAMEL-14469
Switch to maven plugins and remove apt processors
CAMEL-14459
camel-webhook - RAW() parameter value handling in delegated URI
CAMEL-14451
Camel master doesn't build on JDK11
CAMEL-14448
Move all generated source code in git
CAMEL-14445
Remove the property placeholder resolution inside definitions
CAMEL-14444
Build speed improvements
CAMEL-14437
Use a single model / json representation for all internal tooling generators
CAMEL-14415
Camel-itests-spring-boot should be removed from the main repository
CAMEL-14404
Provide a lightweight xml parser
CAMEL-14388
Camel-Slack: Remove username from SlackMessage, since the API doesn't return it anymore
CAMEL-14382
camel-core test failures
CAMEL-14365
Create OpenTracing SpanDecorator for platform-http component
CAMEL-14334
camel-restdsl-openapi-plugin: tests are failing
CAMEL-14331
camel-spring-boot - Dev profile fails
CAMEL-14320
Update building instructions
CAMEL-14314
Camel-AWS Translate: Being able of set source and target language as endpoint options
CAMEL-14295
Camel-cm-sms: Karaf and Spring Boot integration tests are broken
CAMEL-14290
Upgrade to pulsar 2.4.2
CAMEL-14286
camel-osgi-activator Create Examples for Component Usage
CAMEL-14285
came-osgi-activator create tests in project based on Karaf bundle install rather than features
CAMEL-14276
Move camel-core-osgi-activator to components
CAMEL-14274
camel-crypto-cms - Deprecate this component as its hard to maintain
CAMEL-14259
camel-spring-boot - When using main-run-controller then CamelContext is initialized twice
CAMEL-14255
Deadlink for ExchangePattern
CAMEL-14254
Add Camel 3.x migration guide
CAMEL-14244
camel-opentracing - Associate decorators with component FQN also
CAMEL-14239
XSD schema for Camel 3 release for OSGi blueprint put online
CAMEL-14232
camel-ftp: the sftp serverAliveInterval option documentation is not clear
CAMEL-14226
Move spring-boot support into a different repository
CAMEL-14188
Upgrade debezium to 1.0 Final

Test (5)

CAMEL-14566
camel-mongodb - Use testcontainers for testing
CAMEL-14562
camel-elastichsearch - Use testcontainers for testing
CAMEL-14547
camel-itest-karaf - JDK8 tests fails
CAMEL-14304
Unit Test for STOMP Consumer Header Filter Strategy
CAMEL-14260
camel-rabbitmq - Use testcontainers to test with docker

Keys

You can verify your download by following these procedures and using these KEYS.