Sample 14: Sequences and Endpoints as Local Registry Items

Introduction

This sample demonstrates sequences and endpoints fetched from a local registry so that it is possible to have endpoints and sequences as local registry entries including file entries.

Prerequisites

For a list of prerequisites, see the Prerequisites section in ESB Samples Setup.

Building the Sample

1. Start the ESB with sample 14 configuration using the instructions given in Starting Sample ESB Configurations.

2. A message should appear in the command or text Linux console stating the server started successfully.

3. The synapse configuration in the ESB used for message mediation in this sample is provided in <ESB_HOME>/repository/samples/synapse_sample_14.xml as shown below:

<definitions xmlns="http://ws.apache.org/ns/synapse"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://ws.apache.org/ns/synapse http://synapse.apache.org/ns/2010/04/configuration/synapse_config.xsd">
    <localEntry key="local-enrty-ep-key"
                src="file:repository/conf/sample/resources/endpoint/dynamic_endpt_1.xml"/>
    <localEntry key="local-enrty-sequence-key">
        <sequence name="dynamic_sequence">
            <log level="custom">
                <property name="message" value="*** Test Message 1 ***"/>
            </log>
        </sequence>
        <description/>
    </localEntry>
    <sequence name="main">
        <in>
            <sequence key="local-enrty-sequence-key"/>
            <send>
                <endpoint key="local-enrty-ep-key"/>
            </send>
        </in>
        <out>
            <send/>
        </out>
    </sequence>
</definitions>

4. Deploy the back-end service 'SimpleStockQuoteService' and start the Axis2 server using the instructions given in section Starting Sample Back-End Services.

5. Now you have a running ESB instance and a back-end service deployed. In the next section, we will send a message to the back-end service through the ESB using a sample client.

Executing the Sample

The sample client used here is 'Stock Quote Client' which can operate in multiple modes. For instructions on this sample client and its operation modes, refer to Stock Quote Client.

1. Run the following ant command from <ESB_HOME>/samples/axis2Client directory.

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

2. Note the log statement from the fetched sequence from the local entry and the endpoint will be fetched from the specified file at runtime and be cached in the system.