Apache Camel

Apache Camel

Guillaume Nodet
Software Fellow, FuseSource
May 2011

A Progress So*ware Company
1

Agenda

 Who is Guillaume Nodet?
 The birth of Apache Camel
 What is Apache Camel
 A little example
 Whats included in the box?
 Running Camel
 Another Example
 The Camel Community
 Q and A

2 Copyright © 2011 Progress So*ware Corpora9on and/or its subsidiaries or aﬃliates. All rights reserved.  A Progress So*ware Company

Your Presenter is: Guillaume Nodet

 Software Fellow at FuseSource
http://fusesource.com
 Apache Software Foundation Member, VP
Apache Karaf, PMC member of ServiceMix,
ActiveMQ, Camel, Ode, CXF, Geronimo,
Mina, Felix
 Co-creator of ServiceMix, Karaf, Mina SSHD
 Contact
• gnodet@fusesource.com
• gnodet@gmail.com
• http://gnodet.blogspot.com/
• http://twitter.com/gnodet


Agenda

 Running Camel
 Another Example
 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


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



 What are 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



 Recap - Concepts of Camel
• Enterprise Integration Patterns
• Routing
• Domain Specific Language (DSL)
• Endpoints
• URIs
• Predicates & Expressions
• Components

and much more ...

Simplify Integration



 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


Whats included in the box?

 Highlights of whats included in Camel



 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 ﬁle in the JAR


 Powerful bean integration
• Adapt to your beans
• EIP as @annotations
- @Produce
- @Consume
- @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!</hello>");
}
}
}



 The EJB MessageDrivenBean in Camel

public class Foo {

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



 Test Kit
• 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



 Maven tooling
• Maven Archetypes to create new projects

mvn archetype:generate
-DarchetypeGroupId=org.apache.camel.archetypes
-DarchetypeArtifactId=camel-archetype-war
-DarchetypeVersion=2.4.0

• Maven goals to run project
- mvn camel:run
- mvn jetty:run



 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

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

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


Running Camel

 Lightweight
 Embeddable
 Known Deployment Options
• Standalone Java Application Known Containers
• Web Application Apache ServiceMix
Apache ActiveMQ
• J2EE Application
Apache Tomcat
• JBI Jetty
• OSGi JBoss
IBM WebSphere
• Google App Engine BEA WebLogic
• Java Web Start Oracle OC4j
• Spring Application GAE
... others


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
• 40% increase (comparing last two 6 month periods)
• 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 #12


The Camel Community

 JIRA tickets

Total 3047

Open 160 (5%)

Resolved 2887 (95%)

Bugs 5 (4% open)

Oldest Bug June/29/09

Aug 12th 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 273

Camel 2.4 July 2010 182


The Camel Community

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


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
- FUSE website: http://fusesource.com
- Camel in Action book: http://manning.com/ibsen


Questions


Apache Camel

More Related Content

Apache Camel

Editor's Notes