Event-Driven Consumer¶ This page explains how you can implement a sample scenario of the Event-Driven Consumer EIP using WSO2 Integrator: MI. Introduction to Event-Driven Consumer¶ The Event-Driven Consumer EIP allows an application to asynchronously consume messages as they become available. Info For more information, see the Event-Driven Consumer documentation. Sample scenario¶ This EIP is also referred to as an asynchronous receiver. This sample scenario demonstrates how an event will be triggered based on the availability of the receiver and a message will be consumed by the receiver. The diagram below depicts how to simulate the sample scenario using the WSO2 MI. Before digging into implementation details, let's take a look at the relationship between the sample scenario and the Event-Driven Consumer EIP by comparing their core components. Event-Driven Consumer EIP Event-Driven Consumer Sample Scenario Sender Simple Stock Quote Client Message Simple Stock Quote Request Event Driven Consumer Message Processor Receiver Simple Stock Quote Service Synapse configuration of the artifacts¶ Given below is the synapse configuration of this sample. Proxy ServiceMessage StoreMessage ProcessorEndpointSequence <?xml version="1.0" encoding="UTF-8"?> <proxy name="EventDrivenConsumerProxy" startOnLoad="true" transports="http https" xmlns="http://ws.apache.org/ns/synapse"> <target> <inSequence> <property name="FORCE_SC_ACCEPTED" value="true" scope="axis2"/> <property name="OUT_ONLY" value="true"/> <store messageStore="EventDrivenConsumerStore"/> </inSequence> <faultSequence/> </target> </proxy> <?xml version="1.0" encoding="UTF-8"?> <messageStore name="EventDrivenConsumerStore" class="org.apache.synapse.message.store.impl.memory.InMemoryStore" xmlns="http://ws.apache.org/ns/synapse"> </messageStore> <?xml version="1.0" encoding="UTF-8"?> <messageProcessor class="org.apache.synapse.message.processor.impl.sampler.SamplingProcessor" name="EventDrivenConsumerProcessor" messageStore="EventDrivenConsumerStore" xmlns="http://ws.apache.org/ns/synapse"> <parameter name="sequence">SendSeq</parameter> <parameter name="interval">1000</parameter> <parameter name="is.active">true</parameter> <parameter name="concurrency">1</parameter> </messageProcessor> <?xml version="1.0" encoding="UTF-8"?> <endpoint name="SimpleStockEp" xmlns="http://ws.apache.org/ns/synapse"> <address uri="http://localhost:9000/services/SimpleStockQuoteService"> <suspendOnFailure> <initialDuration>-1</initialDuration> <progressionFactor>1</progressionFactor> </suspendOnFailure> <markForSuspension> <retriesBeforeSuspension>0</retriesBeforeSuspension> </markForSuspension> </address> </endpoint> <?xml version="1.0" encoding="UTF-8"?> <sequence name="SendSeq" trace="disable" xmlns="http://ws.apache.org/ns/synapse"> <call> <endpoint key="SimpleStockEp"/> </call> </sequence> Let's investigate the elements of the configuration in detail. store - The store mediator loads the message store. messageStore - Defines the message store to use. messageProcessor - Defines the processing algorithm for stored messages. Set up the sample scenario¶ Install WSO2 Integrator: MI. Info Follow the Install the WSO2 Integrator: MI Runtime documentation for more information. Launch Visual Studio Code with the WSO2 Integrator: MI for VS Code extension (MI for VS Code) installed. Info Follow the Install WSO2 Integrator: MI for VS Code documentation for a complete installation guide. Download the backend service. Extract the downloaded zip file. Open a terminal, and navigate to the axis2Server/bin/ directory inside the extracted folder. Execute the following command to start the axis2server with the SimpleStockQuote backend service: On MacOS/LinuxOn Windows sh axis2server.sh axis2server.bat Download the artifacts of the sample. Import the artifacts to WSO2 MI. Click File -> Open Folder -> Select the extracted ZIP file to import the downloaded ZIP file. Start the project in the WSO2 MI server. For instructions, go to Build and Run Documentation. Execute the sample¶ Send the following request to the EventDrivenConsumerProxy service. POST /services/EventDrivenConsumerProxy HTTP/1.1 Host: localhost:8290 Content-Type: text/xml soapAction: urn:getQuote <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.samples" xmlns:xsd="http://services.samples/xsd"> <soapenv:Header/> <soapenv:Body> <ser:getQuote> <ser:request> <xsd:symbol>foo</xsd:symbol> </ser:request> </ser:getQuote> </soapenv:Body> </soapenv:Envelope> Analyze the output¶ After the request is sent, it will be stored in the configured Message Store. The Sampling Message Processor will then retrieve the request from the store and send it to the axis2server. A message similar to the one shown below will appear in the axis2server, indicating that the request has been accepted. Fri Aug 16 14:02:22 IST 2024 samples.services.SimpleStockQuoteService :: Generating quote for : foo