Skip to content
Apache Camel component for Beanstalk
Find file
Pull request Compare This branch is 81 commits behind osinka:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Camel component for Beanstalk

Beanstalk is a simple work queue service.

Apache Camel is an integration framework.

camel-beanstalk project provides a Camel component for job retrieval and post-processing of Beanstalk jobs.

You can find the detailed explanation of Beanstalk job lifecycle at Beanstalk protocol


This Camel component lets you both request the jobs for processing and supply them to Beanstald daemon. Our simple demo routes may look like

   log("Processing job #${property.beanstalk.jobId} with body ${in.body}").
   process(new Processor() {
     public void process(Exchange exchange) {
       // try to make integer value out of body
       exchange.getIn().setBody( Integer.valueOf(exchange.getIn().getBody(classOf[String])) );
   log("Parsed job #${property.beanstalk.jobId} to body ${in.body}");
   setBody(constant(10)).log("Kick ${in.body} buried/delayed tasks").

In the first route we are listening for new jobs in tube “testTube”. When they are arriving, we are trying to parse integer value from the message body. If done successful, we log it and this successful exchange completion makes Camel component to delete this job from Beanstalk automatically. Contrary, when we cannot parse the job data, the exchange failes and the Camel component buries it by default, so that it can be processed later or probably we are going to inspect failed jobs manually.

So the second route periodically requests Beanstalk to kick 10 jobs out of buried and/or delayed state to the normal queue.

Component URI format

The component URI is


You may omit either port or both host and port: for the Beanstalk defaults to be used (“localhost” and 11300). If you omit tube, Beanstalk component will use the tube with name “default”.

When listening, you may probably want to watch for jobs from several tubes. Just separate them with plus sign, e.g.


Tube name will be URL decoded, so if your tube names include special characters like + or ?, you need to URL-encode them appropriately.

By the way, you cannot specify several tubes when you are writing jobs into Beanstalk.


Common parameters are listed below along with the message header names. Message header always takes the highest precedence over the URI.

Parameter Header Unit Default
jobPriority beanstalk.priority integer 1000 (0 is the highest, see Beanstalk protocol)
jobDelay beanstalk.delay seconds 0
jobTimeToRun beanstalk.timeToRun seconds 60 (when 0, the beanstalkd daemon raises it to 1 automatically, see Beanstalk protocol)

Producer parameters

Producer behaviour is affected by the command parameter which tells what to do with the job, it can be

  • put means to put the job into Beanstalk. Job body is specified in the Camel message body. Job ID will be returned in beanstalk.jobId message header.
  • delete, release, touch or bury expect Job ID in the message header beanstalk.jobId. Result of the operation is returned in beanstalk.result message header
  • kick expects the number of jobs to kick in the message body and returns the number of jobs actually kicked out in the message header beanstalk.result.

Consumer parameters

By default the consumer calls delete on successful job completion and calls bury on failure. You can choose which command to execute in the case of failure by specifying consumer.onFailure parameter in the URI. It can take values of bury, delete or release.

There is a boolean parameter consumer.useBlockIO which corresponds to the same parameter in JavaBeanstalkClient library. By default it is true.

Be careful when specifying release, as the failed job will immediately become available in the same tube and your consumer will try to acquire it again. You can release and specify jobDelay though.

The consumer stores Job ID in the exchange’s property beanstalk.jobId.


Building: prerequisites

Download JavaBeanstalkClient :

git clone git://
cd JavaBeanstalkClient

Install it into the local Maven repository

mvn install

Note, beanstalkd daemon must be running for the tests to pass.


Download “camel-beanstalk” project:

git clone git://
cd camel-beanstalk

Run release:perform with the latest version tag (v1.1.5 is shown below as example):

mvn release:perform -Dtag=v1.1.5

This will install all the project binaries (jar, sources and javadoc) into your local Maven repository.

In your project

Once you have it installed in the local Maven repository, add the dependency into your project’s pom.xml:


(you can find the latest version tag in GitHub repository)


This component is distributed under Apache License 2.0

Something went wrong with that request. Please try again.