Camel x.y.z Release (currently in progress)

New and Noteworthy

Welcome to the x.y.z release which approx XXX issues resolved (new features, improvements and bug fixes such as...)

• Upgraded to JAXB 2.3.0 which is more JDK9 compliant.
• Added better support for javax.jms.StreamMessage types in JMS component.
• Optimised JMS to support ActiveMQ Artemis large messages so you can send and receive big messages such as GB's in size. There is an example demonstrating this in camel-example-artemis-large-messages.
• Added support for route coverage reports which allows 3rd party tooling via SPI to visualise route coverage to Camel developers.
• Added route-coverage goal to the Camel Maven Plugin so you can report route coverage from Maven command line.
• Added support for doing manual commits via Java code when using Kafka consumer.
• Vendor extensions in the swagger generated API docs is now disabled turned off, when using Rest DSL (not all 3rd party API gateways/tooling support vendor extensions). You can turn this back-on via the apiVendorExtension option.
• The SFTP consumer now also supports the useList option which can be used to download a single known file without use LIST operation on the FTP server (which can be slow if the FTP server has many files in the LIST results)
• Camel JSON with camel-jackson will now automatic use shared ObjectMapper instance if there is only one instance in the Registry. For example users with Spring Boot then allows Camel to easily use the default mapper from Spring Boot.
• Added ExtendedStartupListener that allows a callback just after the CamelContext has been fully started.
• You can now specify examples in the Rest DSL that are included in the generated Swagger api-doc via camel-swagger-java.
• Improved file/ftp consumer to use current thread to poll, instead of a scheduled background task, when using pollEnrich (Content Enricher).
• Direct component now blocks by default if sending to a consumer which is not yet ready, which may happen during startup (little window of opportunity). This avoids DirectConsumerNotAvailableException being thrown during startup etc.
• The FTP component can now log progress (turn on transferLoggingLevel) when perfomring download/upload and other operations. You can also find this information for the consumer in JMX. 
• Added support for resuming downloads to FTP component. For example if you download big files and has connection problems with the FTP server. Then later when the connectivity works again, Camel can resume download the in-progress file.

The following issues has been fixed

• Fixed afterApplicationStart callback on camel-spring-boot to be called later and after CamelContext has been fully started.
• Fixed an issue testing with @UseAdviceWith and Camel on Spring Boot.
• Fixed OnCompletion would not be triggered from a route using Splitter and an exception was thrown during splitting.
• Fixed Kafka consumer stops consuming messages when exception occurs during offset commit.
• Fixed Netty4 consumer to stop taking in new requests while being shutdown, as otherwise it cannot graceful shutdown if new requests come in faster than it can process existing in-flight messages.
• Fixed an issue with Routing Slip and Dynamic Router when using context scoped error handler, could cause the error handler to become stopped.

New Enterprise Integration Patterns

New Components

• camel-aws - MQ component for working with Amazon MQ
• camel-elasticsearch5-rest - The elasticsearch component is used for interfacing with ElasticSearch server using 5.x REST API.
• camel-yql - The YQL (Yahoo! Query Language) platform enables you to query, filter, and combine data across the web.

New DSL

• Saga EIP pattern

New Annotations

New Data Formats

New Languages

API breaking

• Minor API changes to org.apache.camel.component.file.GenericFileOperations
• Minor API changes to org.apache.camel.http.common.ServletResolveConsumerStrategy

Known Issues

Important changes to consider when upgrading

• Jetty has been upgraded to 9.4 by default, and camel-jetty is requring version 9.3 or 9.4 to run in OSGi.
• Direct component now blocks by default if sending to a consumer which is not yet ready, which may happen during startup (little window of opportunity). This avoids DirectConsumerNotAvailableException being thrown during startup etc. The old beavhaior can be turned on by setting block=false on the direct component level, or on endpoints where needed.

Getting the Distributions

Binary Distributions

Source Distributions

Getting the Binaries using Maven 2

To use this release in your maven project, the proper dependency configuration that you should use in your Maven POM is:

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-core</artifactId>
  <version>x.y.x</version>
</dependency>

Git Tag Checkout

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

Changelog

For a more detailed view of new features and bug fixes, see the:

• Release notes for x.y.x