This project holds all kinds of Camel demo routes
All things should work :-) if you can follow instructions ...
The reason I chose spring-boot as the glue to make it all work is that spring makes it very easy to integrate all components needed and because of that I can start playing with routes almost immediately
This project works best when run in combination with docker. I've included a
file providing all needed 'middleware'. This enables actually testing the ftp protocol or jms, mq and stuff.
You can read more about that in the docker section.
- docker (native) installed
- docker-compose installed
- java 8 installed
- maven 3+ installed
- a sense of adventure :-)
- a good OS like linux or macOs :-)
Running the demo
In order to be able to run the demo you first need to start the docker containers from the docker-compose file.
Then you can run application by starting CamelDemoApplication from the IDE or with maven:
docker-compose up -d mvn clean package spring-boot:run
What will happen
A scenario something like the one below will play out... it changes as I add new demo's but you'll get the drift:
- a HelloWorld file is located here:
- this file will be copied by the SimpleFileCopyRoute to the
- The SimpleJmsRoute_1 listens here and routes the file to ActiveMQ Queue SimpleJmsRoute
- The SimpleJmsRoute_2 listens here and routes the message to the
test-data/ftp/adminfolder and prints the content of the body to console
- the FtpToFtpRoute will see this because that is the volume "mounted" by the ftp docker container for the admin user.
- The FtpToFtpRoute will copy the file to the ftp
useraccount through the ftp protocol
- it will also move the file in the
adminaccount to a .camel folder
- The FtpToFileRoute will see the file in the ftp
useraccount and copy it to
- it will also move the file in the
useraccount to .camel in its home folder
- the log will also print out something like:
2017-04-13 22:11:25.048 INFO 5473 --- [/startingPoint/] SimpleFileCopyRoute : Found file [HelloWorld.txt] and copying it to: /Users/ivonet/dev/camel-demo/test-data/SimpleJmsRoute/ 2017-04-13 22:11:25.192 INFO 5473 --- [SimpleJmsRoute]] nl.ivonet.route.jms.SimpleJmsRoute : Hello, world! 2017-04-13 22:11:25.666 INFO 5473 --- [localhost:11021] FtpToFtpRoute : Found file [HelloWorld.txt] and cp-ing it to the ftp user: user 2017-04-13 22:11:26.169 INFO 5473 --- [localhost:11021] FtpToFileRoute : Found file [HelloWorld.txt] and copying it to: /Users/ivonet/dev/camel-demo/target/
The whole idea of the above thing is to play around with routes as to get familiar with it.
docker-compose.yml file in this project has been tuned to work for this camel-demo project.
So some volumes have been mounted with a specific goal.
Start / Stop docker-compose
docker-compose up [-d]
the -d option will start in daemon mode
docker-compose down [-v]
the -v option will also remove the volumes created
FTP docker image
In order to demo the ftp routes in this project an ftp server has been configured in the docker-compose file.
This ftp server mounts 'native local' folders in the
test-data/ftp folder but it will also actually enable
the ftp protocol. So the FtpTo*Routes really talk ftp in the demo.
You will be able to see what happens on your native file system though. Please look at the ftp config in the docker-compose file to see how that works.
This project has two users pre-configured:
- USER: admin / PWD: secret
- USER: user / PWD: secret
Their home folders reside in
test-data/ftp and the users have been saved in
docker/ftp/passwd/pureftpd.passwd file as described below.
FTP Create your own user
You can add your own user(s) if you want to play:
First you need to start the ivonet/ftp docker container:
docker run --rm --name ftp \ -v $(pwd)/docker/ftp/passwd:/etc/pure-ftpd/passwd \ -v $(pwd)/target/ftpusers:/home/ftpusers/ \ -p 11021:21 \ -p 30000-30009:30000-30009 \ ivonet/ftp
Then you need to enter the running image:
docker exec -it ftp /bin/bash pure-pw useradd USERHERE -f /etc/pure-ftpd/passwd/pureftpd.passwd -m -u ftpuser -d /home/ftpusers/USERHERE
Exit the image with logout and stop the image with ctrl-c or
docker stop ftp
ActiveMQ docker image
For this demo ActiveMQ has been chosen as the JMS provider and Message Queue middleware.
Mysql docker image
To make looking at the results of what happens to to de db
phpmyadmin has also been included.
- Console (root:secret)
- read more about this image here
- this images looks in
docker/mysql/setupfor initializing sql scripts when the first
docker-compose upis done
- Error handling
- PubSub (topic)
- persisted read/write
- non persisted read/write
- Database as source
- Database as target
- transformation during route
- add routes to routes
- UnitTesting of routes
- usage of direct:...
- usage of mock
- Type conversions
- Processors with exchange type manipulation
- Jaxb2 marshalling / unmarshalling
- GZip / Zip file