Introduction to Apache Camel Components

Introduction to Apache Camel

Claus Ibsen
Principal Software Engineer, FuseSource
September 2010

1

When you joined today‟s session …

Audio is broadcast from your computer

Submit your questions
via the Chat Window

Contact today‟s Host
via the Chat Window

Today's speaker - Claus Ibsen

 Principal Software Engineer at FuseSource
• Full time Apache Camel hacker
 Apache Camel committer
 Co-author of Camel in Action book
• Available in late 2010
 Contact
• claus.ibsen@fusesource.com
• http://davsclaus.blogspot.com/
• http://twitter.com/davsclaus

http://www.manning.com/ibsen

3 © 2010 Progress Software Corporation

Why the name Camel?

Camel is easy to remember and type


Agenda

 The birth of Apache Camel
 What is Apache Camel
 A little example
 What's included in the box?
 Running Camel
 Another Example
 The Camel Community
 Q and A


The birth of Apache Camel

• Camel’s parents



 Initial Commit Log
r519901 | jstrachan | 2007-03-19 11:54:57 +0100
(Mon, 19 Mar 2007) | 1 line

Initial checkin of Camel routing library

 Apache Camel 1.0 released June 2007

 Apache Camel is 3 years old



 My initial commit

r640963 | davsclaus | 2008-03-25 21:07:10 +0100
(Tue, 25 Mar 2008) | 1 line

Added unit test for mistyped URI


Agenda

 Running Camel
 Another Example
 Q and A


What is Apache Camel

 Quote from the web site

Apache Camel is a
Powerful Open Source
Integration Framework
based on known
Enterprise Integration Patterns



 Why do we need Integration?
• Your apps are build using different tech stacks
• Critical for your business to integrate
 Why Integration Framework?
• Framework do the heavy lifting
• Focus on business problem
• Not "reinventing the wheel"



 What is Enterprise Integration Patterns?




Its a book


 Lets look at one of the patterns



 Use Case

ActiveMQ WebSphereMQ



 Filter Pattern



 Filter Pattern

from filter send to
A message B



 Filter Pattern

from(A) filter(predicate) to(B)



 Filter Pattern

from(A) .filter(isWidget) .to(B)



 Filter Route

from(A).filter(isWidget).to(B);



 Filter Route

isWidget = xpath(“/quote/product = „widget‟”);




 Filter Route

Endpoint A = endpoint(“activemq:queue:quote”);

Endpoint B = endpoint(“mq:quote”);

Predicate isWidget = xpath(“/quote/product = „widget‟”);




 Filter Route - Java DSL

public void configure() throws Exception {
Endpoint A = endpoint("activemq:queue:quote");
Endpoint B = endpoint("mq:quote");
Predicate isWidget = xpath("/quote/product = „widget‟");

}




import org.apache.camel.builder.RouteBuilder;
import static org.apache.camel.builder.xml.XPathBuilder.xpath;

public class FilterRoute extends RouteBuilder {

Endpoint A = endpoint("activemq:queue:quote");
Endpoint B = endpoint("mq:quote");
Predicate isWidget = xpath("/quote/product = „widget‟");

}
}




import org.apache.camel.builder.RouteBuilder;

public class FilterRoute extends RouteBuilder {

from("activemq:queue:quote")
.filter().xpath("/quote/product =„widget‟")
.to("mq:quote");
}
}



 IDE Tooling
Code
Assistance

JavaDoc



 IDE Tooling

Code
Assistance



 Lets look at the most famous pattern



 Content Based Router



 Content Based Router - Spring XML

<camelContext>
<route>
<from uri="activemq:NewOrders"/>
<choice>
<when>
<xpath>/order/product = 'widget'</xpath>
<to uri="activemq:Orders.Widgets"/>
</when>
<otherwise>
<to uri="activemq:Orders.Gadgets"/>
</otherwise>
</choice>
</route>
</camelContext>


 Content Based Router - Java DSL

from("activemq:NewOrders")
.choice()
.when().xpath(“/order/product = 'widget'”)
.to(“activemq:Orders.Widget”)
.otherwise()
.to(“acitvemq:Orders.Gadget”);



 Summary
• Camel is an integration framework
• Based on Enterprise Integration Patterns
• Routing and mediation
• Easy to use DSL to define routes
• No heavy specification
• No container dependency
• Payload agnostic
• Connectivity to a great wealth of transports



 Mission Statement

Making integration easier and
more accessible to developers


Agenda

 Running Camel
 Another Example
 Q and A


A little example

 Based on community user (Gunnar Hillert)
• http://hillert.blogspot.com/2009/09/camellos-discovering-apache-
camel-ii.html
 Goals
• 1) Pickup files from a directory
• 2) Make sure we only pickup 3 files per 30 seconds
• 3) Store into JMS queue
• 4) Listen on JMS queue
• 5) And upload file to FTP server


A little example

 Goals using Enterprise Integration Patterns

1 2 3 4 5

 Goals


A little example

 Goals using Enterprise Integration Patterns

from throttle to from to
 Goals


A little example

 Camel DSL in XML

<camelContext>
<route>
<from uri="file:camellos/inbox?move=.done"/>
<throttle maximumRequestsPerPeriod="3”
timePeriodMillis="30000”>
<to uri="activemq:queue:camellos"/>
</throttle>
</route>
<route>
<from uri="activemq:queue:camellos"/>
<to uri="ftp://admin:secret@localhost:3333"/>
</route>
</camelContext>


Agenda

 Running Camel
 Another Example
 Q and A


What's included in the box?

 Highlights of whats included in Camel



 50+ EIP patterns

http://camel.apache.org/enterprise-integration-patterns.html



 70+ Components
activemq crypto flatpack irc ldap

activemq-journal cxf freemarker javaspace mail/imap/pop3

amqp cxfrs ftp/ftps/sftp jbi mina

atom dataset gae jcr mock

bean direct hdfs jdbc msv

bean validation esper hibernate jetty nagios

browse event hl7 jms netty

cache exec http jpa nmr

cometd file ibatis jt/400 printer

http://camel.apache.org/components.html



 70+ Components
properties scalate stream xslt

quartz seda string-template ejb

quickfix servlet test

ref smooks timer

restlet smpp validation

rmi snmp velocity

rnc spring-integration vm

rng spring-security xmpp

rss sql xquery

http://camel.apache.org/components.html



 18 Data Formats
bindy protobuf
castor serialization
csv soap
crypto tidy markup
flatpack xml beans
gzip xml security
hl7 xstream
jaxb zip
json dozer

http://camel.apache.org/data-format.html



 Data Format

from("activemq:QueueWithJavaObjects”)
.marshal().jaxb()
.to("mq:QueueWithXmlMessages");



 Predicates & Expressions

BeanShell PHP
EL Python
Groovy Ruby
JavaScript Simple
JSR 223 SQL
OGNL XPath
MVEL XQuery
http://camel.apache.org/languages.html



 DSL in 3 programming languages
Java
XML

<route>
<from ref="A"/>
<filter>
<xpath>/quote/product = „widget‟</xpath>
<to ref="B"/>
</filter>
</route>
from(A) filter(isWidget) --> B
Scala



 Type Converters

INFO DefaultTypeConverter
- Loaded 148 type converters



 Custom Type Converters

@Converter
public class MyTypeConverter {
@Converter
public String toString(MyOrder order) {
StringBuilder sb = new StringBuilder();
...
return sb.toString();
}
}
# META-INF/services/org/apache/camel/TypeConverter
com.acme.converters
META-INF file in the JAR



 Powerful bean integration
• Adapt to your beans
• EIP as @annotations
- @Produce
- @Consume
- @DynamicRouter
- @RecipientList
- @RoutingSlip

more to come in future releases ...



 Bean as Message Translator



 Bean as Message Translator
from("activemq:Incoming”).
beanRef("myBeanName”, “someMethod").
to("activemq:Outgoing");

public class Foo {
public String someMethod(String name) {
return “Hello “ + name;
}
}



 Bean Parameter Binding with XPath

public class Foo {
public String processOrder(
String orderAsXml,
@XPath(“/order/@id") String oid,
@Header("JMSCorrelationID") String cid) {
...
}
}



 Sending message

public class Foo {
@Produce(uri = "activemq:foo.bar")
ProducerTemplate producer;

public void doSomething() {
if (whatEver) {
producer.sendBody("Hello World");
}
}

}



 Receiving message

public class Foo {

@Consume(uri = "activemq:cheese")
public void onCheese(String name) {
...
}

}



 Test Kit
• camel-test.jar
• JUnit based (3.x and 4.x)
• Supports Spring
• Easy to test
• Quick prototyping



extend CamelTestSupport
 Test Kit from IDE
Right Click ->
Run
Debug

Inline RouteBuilder



 Managed
• JMX API
• REST API



 Web console
• REST API



 FuseSource Rider
•



 Summary
• 50+ EIP patterns
• 70+ Connectivity components
• 15+ Data formats
• 10+ Languages
• DSL in multiple flavors (Java, XML, Scala, Groovy)
• Automatic type conversion
• Strong bean support
• Test Kit
• Management (JMX, REST)
• Web console


Agenda

 Running Camel
 Another Example
 Q and A


Running Camel

 Riding the Camel


Running Camel

 Camel is not a server
 Camel is lightweight and embeddable
 Known Deployment Options
• Standalone Java Application Known Containers
Apache ServiceMix
• Web Application
Apache ActiveMQ
• J2EE Application Apache Tomcat
• JBI Jetty
JBoss
• OSGi IBM WebSphere
• Google App Engine BEA WebLogic
Oracle OC4j
• Java Web Start
GAE
• Spring Application ... others


Running Camel

 Java Application

CamelContext context = new DefaultCamelContext();
context.addRoutes(new MyRouteBuilder());
context.start();

 Spring Application
<camelContext>
<package>com.acme.quotes</package>
</camelContext>


Agenda

 Running Camel
 Another Example
 Q and A


Another Example

 Rider Auto Parts Example by Jonathan Anstey
http://architects.dzone.com/articles/apache-camel-integration


Another Example

 Rider Auto Parts Example - 3 Routes

1


Another Example


1

2


Another Example


1

3
2


Another Example

 Rider Auto Parts Example - 1st Route
from 1

to

public class Route1 extends RouteBuilder {

from("ftp:user@rider.com?password=secret")
.to("activemq:queue:incoming");
}
}

Another Example

 Rider Auto Parts Example - 2nd Route

from to
2


from("jetty:http://localhost:8080/orders")
.inOnly("activemq:queue:incoming")
.transform().constant("OK");
}
}


Another Example

 Rider Auto Parts Example - 3rd Route

3
from to

choice

route on next slide


Another Example

 Rider Auto Parts Example - 3rd Route
JaxbDataFormat jaxb = new JaxbDataFormat("com.rider");

from("activemq:queue:incoming")
.convertBodyTo(String.class)
.choice()
.when().method("helper”, "isXml")
.unmarshal(jaxb)
.to("activemq:queue:order")
.when().method("helper”, "isCsv")
.unmarshal().csv()
.beanRef("orderService”, "csvToXml")
.to("activemq:queue:order")
}
}


Agenda

 Running Camel
 Another Example
 Q and A


The Camel Community

 Camel website
• 52% increase (2010 over 2009)
• Average 2200 visits per weekday (2000 - 2500)

 High activity on mailing list


The Camel Community

 20 committers

 High commit activity

http://markmail.org/


The Camel Community

 Books - Bestseller
• Manning top-15 year to date (2010)

#10


The Camel Community

 JIRA tickets

Total 3106

Open 136 (4%)

Resolved 2970 (96%)

Bugs 2 (2% open)

Oldest Bug Dec 2009

Sep 6th 2010


The Camel Community

 A lot in each new release

Release Date Tickets
Camel 2.0 Aug 2009 760
Camel 2.1 Dec 2009 303
Camel 2.2 Feb 2010 180
Camel 2.3 May 2010 278
Camel 2.4 July 2010 182
Camel 2.5 Sep 2010 170+


The Camel Community

 3rd party integrating Camel
• Apache ServiceMix
• Apache ActiveMQ
• Apache James In Progress
• OpenESB • Smooks
• Progress Actional Diagnostics • Doozer
• FuseHQ
• Open eHealth Integration Platform
• Grails Camel Plugin
• Play Framework
• Akka
• Scalate
• JBoss Drools
• JBoss ESB

Agenda

 Running Camel
 Another Example
 Q and A


Q and A

 Where do I get more information?
Camel website: http://camel.apache.org
Camel article: http://architects.dzone.com/articles/apache-camel-integration
FuseSource website: http://fusesource.com
Camel in Action book: http://manning.com/ibsen


Q and A


Introduction to Apache Camel Components

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Introduction to Apache Camel Components

Similar to Introduction to Apache Camel Components (20)

More from Claus Ibsen

More from Claus Ibsen (20)

Recently uploaded

Recently uploaded (20)

Introduction to Apache Camel Components