-
Java 17 or higher
-
Apache Camel 4.x
It is possible to route fragments to Apache Camel endpoints using the <camel:route>
configuration from the https://www.smooks.org/xsd/smooks/camel-1.5.xsd
configuration namespace.
For example, you can route to Camel endpoint by specifying the following in your Smooks configuration:
<smooks-resource-list xmlns="https://www.smooks.org/xsd/smooks-2.0.xsd"
xmlns:camel="https://www.smooks.org/xsd/smooks/camel-1.5.xsd">
<!-- Create some bean instances from the input source... -->
<jb:bean beanId="orderItem" ...>
<!-- etc... See Smooks Java Binding docs -->
</jb:bean>
<!-- Route bean to camel endpoints... -->
<camel:route beanid="orderItem">
<camel:to endpoint="direct:slow" if="orderItem.priority == 'Normal'"/>
<camel:to endpoint="direct:express" if="orderItem.priority == 'High'"/>
</camel:route>
</smooks-resource-list>
In the above example, we route Java Beans from Smooks’s BeanContext
to the Camel Endpoints. Note that you can also apply templates (e.g., FreeMarker) to these same beans and route the templating result instead of beans (e.g., as XML, CSV or other).
The above configuration shows routing using the beanId
attribute. It is also possible to route using an attribute named routeOnElement
.
Integrating Smooks from Apache Camel lets you access all the features of Smooks from within Camel. You can take an existing Smooks configuration and use this in your Camel routes using one of the options that are described in this chapter.
Using Smooks in Camel can be done in three ways:
Warning
|
SmooksComponent is deprecated and superseded by the Camel Smooks Component. |
The SmooksComponent
is a Camel Component which can used when you want to process the Camel Message Body using Smooks. You can do this by adding a route in your Camel route configuration:
from("file://inputDir?noop=true")
.to("smooks://smooks-config.xml")
.to("jms:queue:order")
The Smooks Component is configured with a mandatory configuration file, which is smooks-config-xml in the example above. By just looking at the above route definition it is not clear what type of output that the SmooksComponent is producing. This is actually expressed in the Smooks configuration using the exports element.
If you prefer/require programmatic configuration of Smooks you can use the SmooksProcessor
to achieve this.
SmooksDataFormat
is a Camel DataFormat which is capable of transforming from one data format to another and back again. You would use this when you are only interested in transforming from one format to another and not interested in other Smooks features.
Below is an example of using SmooksDataFormat
to transform a comma separated value string into a java.util.List
of Customer object instances:
SmooksDataFormat sdf = new SmooksDataFormat("csv-smooks-unmarshal-config.xml");
from("direct:unmarshal")
.unmarshal(sdf)
.convertBodyTo(List.class)
.to("mock:result");
Warning
|
SmooksProcessor is deprecated and superseded by the Camel Smooks Component. |
Using SmooksProcessor
gives you full control over Smooks, for example if you want to programmatically create the underlying Smooks instance you’d use SmooksProcessor
. When using SmooksProcessor
, you can pass a Smooks instance to its constructor and prior to that programmatically configure Smooks.
Below is an example of using the SmooksProcessor
in a Camel route:
Smooks smooks = new Smooks("edi-to-xml-smooks-config.xml");
ExecutionContext context = smooks.createExecutionContext();
...
SmooksProcessor processor = new SmooksProcessor(smooks, context);
from("file://input?noop=true")
.process(processor)
.to("mock:result");
Similar to the SmooksComponent
we have not specified the result type that Smooks produces (if any that is). Instead this is expressed in the Smooks configuration using the exports element, or you can do the same programmatically like this:
Smooks smooks = new Smooks();
ExecutionContext context = smooks.createExecutionContext();
smooks.setExports(new Exports(StringResult.class));
SmooksProcessor processor = new SmooksProcessor(smooks, context);
...
from("file://input?noop=true")
.process(processor)
.to("mock:result");
Tip
|
See the Apache Camel examples in the examples page. |
<dependency>
<groupId>org.smooks.cartridges</groupId>
<artifactId>smooks-camel-cartridge</artifactId>
<version>2.0.0</version>
</dependency>
Smooks Camel Cartridge is open source and licensed under the terms of the Apache License Version 2.0, or the GNU Lesser General Public License version 3.0 or later. You may use Smooks Camel Cartridge according to either of these licenses as is most appropriate for your project.
SPDX-License-Identifier: Apache-2.0 OR LGPL-3.0-or-later