Camel-Examples/spring-boot-packaging

Spring Boot packaging for Camel

Goals

Spring Boot enables you to package your Camel routes along with any required dependency. A "fat jar" is produced and can be run with just a java -jar /path/to/app.jar.

In this example, we will package the Camel routes as a Spring Boot application.

How this project has been created

Generate a new Maven project using the camel-archetype-spring-boot archetype:

mvn archetype:generate -DarchetypeGroupId=org.apache.camel.archetypes -DarchetypeArtifactId=camel-archetype-spring-boot -DarchetypeVersion=2.21.1 -DinteractiveMode=false -DgroupId=fr.itix.camel-examples -DartifactId=spring-boot-packaging -Dversion=1.0-SNAPSHOT -Dpackage=fr.itix.camel.spring_boot_packaging

By default, the camel-archetype-spring-boot archetype creates a sample route using the Java DSL. In this example, we will use the Spring DSL, so you can remove the two following classes:

rm src/main/java/fr/itix/camel/spring_boot_packaging/MySpringBean.java
rm src/main/java/fr/itix/camel/spring_boot_packaging/MySpringBootRouter.java

Create a camel directory in src/main/resources:

mkdir src/main/resources/camel/

Create an hello-world.xml file in the newly created camel directory with this content:

<routes xmlns="http://camel.apache.org/schema/spring">
  <route id="hello-world">
    <from uri="timer:hello?period=1000"/>
    <log message="Hello, world !" />
  </route>
</routes>

Try it !

Each time you changed something in your camel-context.xml, you will have to re-run Camel with:

mvn package spring-boot:run

If you followed the instructions, you should have something like this:

[INFO] --- spring-boot-maven-plugin:1.5.12.RELEASE:run (default-cli) @ spring-boot-packaging ---

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::       (v1.5.12.RELEASE)

2018-06-05 12:40:51.475  INFO 24580 --- [           main] f.i.c.s.MySpringBootApplication          : Starting MySpringBootApplication on nmasse-OSX.local with PID 24580 (/Users/nmasse/git/perso/Camel-Examples/spring-boot-packaging/target/classes started by nmasse in /Users/nmasse/git/perso/Camel-Examples/spring-boot-packaging)
2018-06-05 12:40:51.477  INFO 24580 --- [           main] f.i.c.s.MySpringBootApplication          : No active profile set, falling back to default profiles: default

[...]

2018-06-05 12:40:54.527  INFO 24580 --- [           main] o.a.camel.spring.boot.RoutesCollector    : Loading additional Camel XML routes from: classpath:camel/*.xml
2018-06-05 12:40:55.006  INFO 24580 --- [           main] o.a.camel.spring.boot.RoutesCollector    : Loading additional Camel XML rests from: classpath:camel-rest/*.xml
2018-06-05 12:40:55.020  INFO 24580 --- [           main] o.a.camel.spring.SpringCamelContext      : Apache Camel 2.21.1 (CamelContext: MyCamel) is starting
2018-06-05 12:40:55.021  INFO 24580 --- [           main] o.a.c.m.ManagedManagementStrategy        : JMX is enabled
2018-06-05 12:40:55.190  INFO 24580 --- [           main] o.a.camel.spring.SpringCamelContext      : StreamCaching is not in use. If using streams then its recommended to enable stream caching. See more details at http://camel.apache.org/stream-caching.html
2018-06-05 12:40:55.205  INFO 24580 --- [           main] o.a.camel.spring.SpringCamelContext      : Route: hello-world started and consuming from: timer://hello?period=1000
2018-06-05 12:40:55.207  INFO 24580 --- [           main] o.a.camel.spring.SpringCamelContext      : Total 1 routes, of which 1 are started
2018-06-05 12:40:55.207  INFO 24580 --- [           main] o.a.camel.spring.SpringCamelContext      : Apache Camel 2.21.1 (CamelContext: MyCamel) started in 0.187 seconds
2018-06-05 12:40:55.263  INFO 24580 --- [           main] b.c.e.u.UndertowEmbeddedServletContainer : Undertow started on port(s) 8080 (http)
2018-06-05 12:40:55.271  INFO 24580 --- [           main] f.i.c.s.MySpringBootApplication          : Started MySpringBootApplication in 4.173 seconds (JVM running for 7.038)
2018-06-05 12:40:56.222  INFO 24580 --- [- timer://hello] hello-world                              : Hello, world !
2018-06-05 12:40:57.216  INFO 24580 --- [- timer://hello] hello-world                              : Hello, world !
2018-06-05 12:40:58.216  INFO 24580 --- [- timer://hello] hello-world                              : Hello, world !
2018-06-05 12:40:59.217  INFO 24580 --- [- timer://hello] hello-world                              : Hello, world !

Note: you will have to press Ctrl-C to exit this Hello World example!

Packaging

As you might have noticed, by default this archetype generates a fat jar:

$ ls -lh target/*.jar
-rw-r--r--  1 nmasse  staff    21M Jun  5 12:40 target/spring-boot-packaging-1.0-SNAPSHOT.jar

When ready, you can copy the fat jar on another server and run it:

java -jar target/spring-boot-packaging-1.0-SNAPSHOT.jar

References

• Camel Archetypes
• Spring Boot support for Camel