This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit

Competing Consumers

This section explains, through an example scenario, how the Competing Consumers EIP can be implemented using WSO2 ESB. The following topics are covered:

Introduction to Competing Consumers

The Competing Consumers EIP relates to multiple consumers that compete with each other to receive a request from a given Point-to-Point Channel. In this pattern, requests are handled and delegated similar to how messages are handled in the Point-to-Point channel using the round-robin algorithm. For more information, refer to

Figure 1: Competing Consumers EIP

Example scenario

In this example scenario, each Axis2 server instance acts as a consumer waiting for a specific message. When the client sends a message to WSO2 ESB, it diverts the request based on the round-robin algorithm among the consumers. This way, the consumers receive a request message adhering to the conditions of the algorithm.

An alternative implementation to the Competing Consumers EIP is to use a Content-Based Router and route messages to different receivers based on the content of a message.

The diagram below depicts how to simulate the example scenario using the WSO2 ESB.

Figure 2: Example Scenario of the Competing Consumers EIP

Before digging into implementation details, let's take a look at the relationship between the example scenario and the Competing Consumers EIP by comparing their core components.

Competing Consumers EIP (Function 1)Competing Consumers Example Scenario (Function 2)
SenderSimple Stock Quote Client
MessagesSimple Stock Quote Requests with Load-Balance Endpoint
Consumer/ReceiverSimple Stock Quote Server Instances

Environment setup

  1. Download and install WSO2 ESB from For a list of prerequisites and step-by-step installation instructions, refer to Installation Guide in the WSO2 ESB documentation.
  2. Start three sample Axis2 server instances on ports 9000, 9001, and 9002. For instructions, refer to the section Setting Up the ESB Samples - Starting the Axis2 server in the WSO2 ESB documentation.

ESB configuration

Start the ESB server and log into its management console UI (https://localhost:9443/carbon). In the management console, navigate to the Main menu and click Source View in the Service Bus section. Next, copy and paste the following configuration, which helps you explore the example scenario, to the source view.

<definitions xmlns="">
   <sequence name="fault">
      <log level="full">
         <property name="MESSAGE" value="Executing default &#34;fault&#34; sequence"/>
         <property name="ERROR_CODE" expression="get-property('ERROR_CODE')"/>
         <property name="ERROR_MESSAGE" expression="get-property('ERROR_MESSAGE')"/>
   <sequence name="main">
               <loadbalance algorithm="org.apache.synapse.endpoints.algorithms.RoundRobin">
                     <address uri="http://localhost:9000/services/SimpleStockQuoteService/"/>
                     <address uri="http://localhost:9001/services/SimpleStockQuoteService/"/>
                     <address uri="http://localhost:9002/services/SimpleStockQuoteService/"/>

Simulating the sample scenario

Repeatedly send several requests to the ESB using the stockquote client as follows:

ant stockquote -Dtrpurl=http://localhost:8280/ -Dsymbol=foo

Following is the request sent by the stockquote client in this example.

<soapenv:Envelope xmlns:soapenv="" xmlns:ser="http://services.samples" xmlns:xsd="http://services.samples/xsd">
   <soapenv:Header />

Note in each Axis2 server console that the requests are distributed among several servers. Each server is acting as a competing consumer.

How the implementation works

Let's investigate the elements of the ESB configuration in detail. The line numbers below refer to the ESB configuration shown above.

  • endpoint [line 13 in ESB config] - Defines the endpoint where the request should be sent. 
  • loadbalance [line 14 in ESB config] - Defines a set of endpoints where incoming requests are distributed using a particular algorithm. In this example, the algorithm distributes messages in a round-robin manner.