Presentation from ApacheCon US 2008

1. Taking
Apache Camel
For A Ride
Bruce Snyder
bsnyder@apache.org
7 Nov 2008
New Orleans, Louisiana

2. Protocol Integration
is Common

3. Data Format Integration
is Common

4. Integration is Messy!

6. SOA = Spaghetti Oriented
Architecture

8. Options For Integration
1 2
3

9. Too Many Choices!

10. The Easiest Solution - Apache
Camel
http://activemq.apache.org/camel/

11. What is
Apache Camel?

12. Enterprise Integration
Patterns
http://enterpriseintegrationpatterns.com/

13. Message Routing

14. Patterns

15. History of Apache Camel

16. Camel Components
http://activemq.apache.org/camel/components.html

17. Camel Components

18. Simple Routing

19. More Simple Routing

20. Pipeline Routing

21. Multicast Routing

22. Multicast-to-Many
Pipeline Routes

23. Language Support
For Message Processing
• BeanShell • JSP EL
• Javascript • OGNL
• Groovy • SQL
• Python • XPath
• PHP • XQuery
• Ruby

24. Getting Started -
The Camel Context
CamelContext context = new DefaultCamelContext();
context.addRoutes(new MyRouteBuilder());
context.start();
<camelContext
xmlns=quot;http://activemq.apache.org/camel/schema/springquot;>
<package>com.acme.quotes</package>
</camelContext>

25. Pattern
Examples

26. Patterns

27. Content Based Router
RouteBuilder builder = new RouteBuilder() {
public void configure() {
from(quot;seda:aquot;).choice().when(header(quot;fooquot;)
.isEqualTo(quot;barquot;)).to(quot;seda:bquot;)
.when(header(quot;fooquot;).isEqualTo(quot;cheesequot;))
.to(quot;seda:cquot;).otherwise().to(quot;seda:dquot;);
}
};

28. Content Based Router
<camelContext
xmlns=quot;http://activemq.apache.org/camel/schema/springquot;>
<route>
<from uri=quot;activemq:NewOrdersquot;/>
<choice>
<when>
<xpath>/order/product = 'widget'</xpath>
<to uri=quot;activemq:Orders.Widgetsquot;/>
</when>
<when>
<xpath>/order/product = 'gadget'</xpath>
<to uri=quot;activemq:Orders.Gadgetsquot;/>
</when>
<otherwise>
<to uri=quot;activemq:Orders.Badquot;/>
</otherwise>
</choice>
</route>
</camelContext>

29. Message Filter
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;activemq:topic:Quotes).
filter().xpath(quot;/quote/product = ‘widget’quot;).
to(quot;mqseries:WidgetQuotesquot;);
}
}

30. Message Filter
<camelContext
xmlns=quot;http://activemq.apache.org/camel/schema/springquot;>
<route>
<from uri=quot;activemq:topic:Quotesquot;/>
<filter>
<xpath>/quote/product = ‘widget’</xpath>
<to uri=quot;mqseries:WidgetQuotesquot;/>
</filter>
</route>
</camelContext>

31. Splitter
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;file://ordersquot;).
splitter(body().tokenize(quot;nquot;)).
to(quot;activemq:Order.Itemsquot;);
}
}

32. Splitter Using XQuery
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;file://ordersquot;).
splitter().xquery(quot;/order/itemsquot;).
to(quot;activemq:Order.Itemsquot;);
}
}

33. Aggregator
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;activemq:Inventory.Itemsquot;).
aggregator(header(quot;symbolquot;).isEqualTo(quot;IBMquot;).
to(quot;activemq:Inventory.Orderquot;);
}
}

34. Message Translator
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;file://incoming”).
to(quot;xslt:com/acme/mytransform.xslquot;).
to(quot;http://outgoing.com/fooquot;);
}
}

35. Resequencer
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;direct:a”).
resequencer(header(quot;customerRankquot;)).
to(quot;seda:bquot;);
}
}

36. Routing Slip
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;direct:a”).routingSlip();
}
}

37. Throttler
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;seda:a”).
throttler(3).timePeriodMillis(30000).
to(quot;seda:bquot;);
}
}

38. Delayer
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;seda:a”).
delayer(header(quot;JMSTimestampquot;, 3000).
to(quot;seda:bquot;);
}
}

39. Load Balancer
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;file:/path/to/filequot;).
loadBalance().roundRobin().
to(quot;seda:aquot;, quot;seda:bquot;, quot;seda:cquot;);
}
}
Policy Description
Round Robin Balance the exchange load across the available endpoints
Random Randomly choose an endpoint to send the exchange
Sticky Sticky load balancing of exchanges using an expression
Topic Send exchange to all endpoints (like a JMS topic)

40. Multicast
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;direct:aquot;).
multicast().
to(quot;direct:x?x=y&amp;1=2quot;, quot;direct:yquot;, quot;direct:zquot;);
}
}

41. Demo

42. More
Patterns

43. Wire Tap
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;direct:aquot;).
to(quot;log:com.mycompany.messages?level=infoquot;).
to(quot;mock:fooquot;);
}
}

44. Content Enricher
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;activemq:My.Queuequot;).
to(quot;velocity:com/acme/MyResponse.vmquot;).
to(quot;activemq:Another.Queuequot;);
}
}

45. More Content Enricher
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;activemq:My.Queuequot;).
beanRef(quot;myBeanNamequot;, quot;myMethodNamequot;).
to(quot;activemq:Another.Queuequot;);
}
}

46. Content Filter
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;direct:startquot;).process(new Processor() {
public void process(Exchange exchange) {
Message in = exchange.getIn();
in.setBody(in.getBody(String.class) + quot; World!quot;);
}
}).to(quot;mock:resultquot;);
}
}

47. Combine Patterns
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;seda:a”).
resequencer(header(quot;JMSGroupSeqquot;)).
delayer(3000).
to(quot;mock:xquot;);
}
}

48. Configure Error Handling
Global Error Handler:
RouteBuilder builder = new RouteBuilder() {
public void configure() {
errorHandler(deadLetterChannel(quot;file:errorsquot;));
from(quot;bean:fooquot;).to(quot;seda:bquot;);
}
};

49. Configure Error Handling
Local Error Handler:
RouteBuilder builder = new RouteBuilder() {
public void configure() {
from(quot;seda:aquot;).
errorHandler(loggingErrorHandler(quot;FOO.BARquot;)).
to(quot;seda:bquot;);
from(quot;seda:bquot;).to(quot;seda:cquot;);
}
};

50. Configure Exception Policies
RouteBuilder builder = new RouteBuilder() {
public void configure() {
exception(IOException.class)
.initialRedeliveryDelay(5000L)
.maximumRedeliveries(3)
.maximumRedeliveryDelay(30000L)
.backOffMultiplier(1.0)
.useExponentialBackOff()
.setHeader(MESSAGE_INFO, constant(quot;Damned IOException!quot;))
.to(quot;activemq:errorsquot;);
from(quot;seda:aquot;).to(quot;seda:bquot;);
}
};

51. Beans

52. Make Context Discover Beans
package com.mycompany.beans;
public class MyBean {
public void someMethod(String name) {
...
}
}
<camelContext
xmlns=quot;http://activemq.apache.org/camel/schema/springquot;>
<package>com.mycompany.beans</package>
</camelContext>

53. Bean as a Message Translator
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;activemq:Incoming”).
beanRef(quot;myBeanquot;).
to(quot;activemq:Outgoingquot;);
}
}

54. Bean as a
Message Translator
*With Method Name
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;activemq:Incoming”).
beanRef(quot;myBeanquot;, quot;someMethodquot;).
to(quot;activemq:Outgoingquot;);
}
}

55. Binding Beans to
Camel Endpoints
public class Foo {
@MessageDriven(uri=quot;activemq:cheesequot;)
public void onCheese(String name) {
...
}
}

56. Binding Method Arguments
public class Foo {
public void onCheese(
@XPath(quot;/foo/barquot;) String name,
@Header(quot;JMSCorrelationIDquot;) String id) {
...
}
}

57. Injecting Endpoints
Into Beans
public class Foo {
@EndpointInject(uri=quot;activemq:foo.barquot;)
ProducerTemplate producer;
public void doSomething() {
if (whatever) {
producer.sendBody(quot;<hello>world!</hello>quot;);
}
}
}

58. Type Conversion

59. Type Conversion
@Converter
public class IOConverter {
@Converter
public static InputStream toInputStream(File file)
throws FileNotFoundException {
return new BufferedInputStream(
new FileInputStream(file));
}
}

60. Type Convertors
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;direct:startquot;).process(new Processor() {
public void process(Exchange exchange) {
Message in = exchange.getIn();
in.setBody(in.getBody(String.class) + quot; World!quot;);
}
}).to(quot;mock:resultquot;);
}
}
Support for the following types:
• File
• String
• byte[] and ByteBuffer
• InputStream and OutputStream
• Reader and Writer
• Document and Source

61. Message Mapper

62. Message Translator
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;file://incoming”).
to(quot;xslt:com/acme/mytransform.xslquot;).
to(quot;http://outgoing.com/fooquot;);
}
}

63. Another
Message Translator
public class MyRouteBuilder extends RouteBuilder {
public void configure() {
from(quot;activemq:FOO.TEST”).
transform(body().append(getDynamicText())).
to(quot;http://outgoing.com/fooquot;);
}
}

64. Business Activity Monitoring
(BAM)

65. Business Activity Monitoring
(BAM)
public class MyActivities extends ProcessBuilder {
public void configure() throws Exception {
// lets define some activities, correlating on an
// XPath query of the message body
ActivityBuilder purchaseOrder = activity(quot;activemq:PurchaseOrdersquot;)
.correlate(xpath(quot;/purchaseOrder/@idquot;).stringResult());
ActivityBuilder invoice = activity(quot;activemq:Invoicesquot;)
.correlate(xpath(quot;/invoice/@purchaseOrderIdquot;).stringResult());
// now lets add some BAM rules
invoice.starts().after(purchaseOrder.completes())
.expectWithin(seconds(1))
.errorIfOver(seconds(2)).to(quot;activemq:FailedProcessesquot;);
}
}

66. Complex Routing is Easier
from(“http://localhost:8080/requests/”).
tryBlock().
to(“activemq:queue:requests”).
setOutBody(constant(“<ack/>”)).
handle(Throwable.class).
setFaultBody(constant(“<nack/>”));
from((“activemq:queue:requests?transacted=true”).
process(requestTransformer).
to(“http://host:8080/Request”).
filter(xpath(“//nack”)).
process(nackTransformer).
to(“jdbc:store”);
from(“http://localhost:8080/responses/”).
tryBlock().
to(“activemq:queue:responses”).
setOutBody(constant(“<ack/>”)).
handle(Throwable.class).
setFaultBody(constant(“<nack/>”));
from(“activemq:queue:responses?transacted=true”).
process(responseTransformer).
to(“jdbc:store”);
from(“http://localhost:8080/pull/”).
to(“jdbc:load”);

67. Finally, the Camel Truck!

68. Ride the Camel!
http://activemq.apache.org/camel/