}
h2. New and Noteworthy
Welcome to the 1.4.0 release which includes 261 new features, improvements and bug fixes such as...
* [] []
* [ ]
* [ ] [ ]
* [Message]
* various improvements in [CXF], [File|File2], [FTP|FTP2], [Velocity], [Stream], [Atom] and [XMPP] components
* various improvements in the Java and Spring DSL
* new transaction error handler, see [Transactional Client]
* introduced [ExceptionPolicyStrategy|Dead Letter Channel] as strategy for exception clause selection during error handling (much improved default strategy in Camel)
* intercept() default behavior changed (see section - important changes)
* JMS headers now preserve packagename style headers so [Bean] and [File|File2] headers is preserved, so you can safely send the filename or bean method to invoke over the JMS wire
* introduced [Debugger] and [Tracer] interceptor to track how exchanges is routed
* refinements to run in OSGi containers
* some internal refactorings of package structure to avoid cycle dependencies
* @deprecated some core classes, that will be removed in Camel 2.0
* improved feedback for misconfiguration of camel routes such as mistypes of parameters
* overall improved wiki documentation
* improved javadoc for camel-core and camel-spring
* dependencies is now on the finer grained jars if applicable (e.g. Spring)
* WebSphere 6.1 support
h3. New [Enterprise Integration Patterns]
* None
h3. New [Components]
* [Flatpack] for processing fixed width or delimited files or messages using the FlatPack library (work in progress)
* [SpringIntegration] for integration with Spring Integration
h3. New DSL
* [Scala|Scala DSL] (work in progress, not fully feature complete)
h3. New [Data Formats|Data Format]
* None
h3. New [Languages]
* None
h3. New Examples
* ANT build files for running the examples
* [camel-example-loan-broker|Loan Broker Example]
* [camel-example-spring-jms|tutorial-jmsremoting]
h2. API breakings
Potentially there can be an API breaking when upgrading from Camel 1.3 or older. We are sorry for this and will try to refrain from such API breakings in the future Camel 1.x releases. An API overhaul is scheduled for Camel 2.0.
h2. Known Issues
* The [Tracer] and [Log] can cause a NPE if the Message Body is {{null}}. A workaround is to configure it with {{showBody=false}}.
h2. Important changes to consider when upgrading
h3. CamelTemplate marked as @deprecated
CamelTemplate has been marked as @deprecated and you should use ProducerTemplate instead.
From Camel 1.4.0 on the ProducerTemplate must be retrieved from the CamelContext. You can then use it the same way as before.
{code}- Message
- various improvements in CXF, File, FTP, Velocity, Stream, Atom and XMPP components
- various improvements in the Java and Spring DSL
- new transaction error handler, see Transactional Client
- introduced ExceptionPolicyStrategy as strategy for exception clause selection during error handling (much improved default strategy in Camel)
- intercept() default behavior changed (see section - important changes)
- JMS headers now preserve packagename style headers so Bean and File headers is preserved, so you can safely send the filename or bean method to invoke over the JMS wire
- introduced Debugger and Tracer interceptor to track how exchanges is routed
- refinements to run in OSGi containers
- some internal refactorings of package structure to avoid cycle dependencies
- @deprecated some core classes, that will be removed in Camel 2.0
- improved feedback for misconfiguration of camel routes such as mistypes of parameters
- overall improved wiki documentation
- improved javadoc for camel-core and camel-spring
- dependencies is now on the finer grained jars if applicable (e.g. Spring)
- WebSphere 6.1 support
- Flatpack for processing fixed width or delimited files or messages using the FlatPack library (work in progress)
- SpringIntegration for integration with Spring Integration
New DSL- Scala (work in progress, not fully feature complete)
New ExamplesAPI breakingsPotentially there can be an API breaking when upgrading from Camel 1.3 or older. We are sorry for this and will try to refrain from such API breakings in the future Camel 1.x releases. An API overhaul is scheduled for Camel 2.0. Known Issues- The Tracer and Log can cause a NPE if the Message Body is
null . A workaround is to configure it with showBody=false .
Important changes to consider when upgradingCamelTemplate marked as @deprecatedCamelTemplate has been marked as @deprecated and you should use ProducerTemplate instead. From Camel 1.4.0 on the ProducerTemplate must be retrieved from the CamelContext. You can then use it the same way as before. Code Block |
---|
ProducerTemplate camelTemplate = camelContext.createProducerTemplate();
| {code}
After usage of the template, you must call {{stop() }} to let it release any resources obtained. See this [FAQ entry |Why does Camel use too many threads with ProducerTemplate].
h3. [Bean] component minor change
Bean component sets a reference to the bean that is being invoked as a property on the Exchange. This property has change its key from "CamelBean" to . Bean component minor changeBean component sets a reference to the bean that is being invoked as a property on the Exchange. This property has change its key from "CamelBean" to "org.apache.camel.bean.BeanHolder" and the type is now a BeanHolder.
h3. Unit test kits
The unit test kits camel-core-tests.jar and camel-spring-tests.jar is no longer distributed with the binary distribution. These jars can be downloaded from maven repositories.
h3. JMX
In Camel JMXIn Camel 1.4 the [Camel JMX ] agent has been enabled by default. To disable it, as the default in previous versions, you have to explicitly disable it. See the [Camel JMX ] documentation for details.
h3. Default behavior of intercept() changed
In Camel 1.4 the DSL for intercept() has changed its default behavior to proceed by default.
In Camel 1.3 you had to do this:
{} |
---|
intercept().log("log:orders").proceed();
from("direct:order").to("seda:verifyOrder");
...
| {code}
In Camel 1.4 the proceed is default:
{} |
---|
intercept().log("log:orders");
from("direct:order").to("seda:verifyOrder");
...
| {code}
And in Camel 1.3 stop was default:
{} |
---|
intercept(header("user").isEqualTo("test")).log("log:test");
from("direct:order").to("seda:verifyOrder");
...
| {code}
In Camel In Camel 1.4 you have to explicit state the stop:
{} |
---|
intercept(header("user").isEqualTo("test")).log("log:test").stop();
from("direct:order").to("seda:verifyOrder");
...
| {code}
In the last two examples we want to filter out all orders by a test user. In Camel 1.4 we need to use the {{stop() }} to stop the intercept chain from proceeding.
h3. URI validation
Camel is now more strict when it comes to validation of URI configuration. If a parameter name couldn't be resolved Camel will throw an Exception. In this regard the [File |File2] component you must change the delay parameters to have the {{consumer. }} prefix. {{delay }} should be {{consumer.delay }}.
h3. DeadLetterChannel
[DeadLetterChannel|Dead Letter Channel] is now disabled if in transacted mode. Use the new transaction error handler instread, see [Transactional Client].
{div}. DeadLetterChannelDeadLetterChannel is now disabled if in transacted mode. Use the new transaction error handler instread, see Transactional Client. |