Sequence Template

A Sequence Template is a parametrized sequence , providing an abstract or generic form of a sequence defined in the ESB profile. Parameters of a template are defined in the form of XPath statement/s. Callers can invoke the template by populating the parameters with static values/XPath expressions using the Call Template Mediator, which makes a sequence template into a concrete sequence.

Configuration

Let's illustrate the sequence template with a simple example. Suppose we have a sequence that logs the text "hello world" in four different languages.

<sequence>
   <switch source="//m0:greeting/m0:lang" xmlns:m0="http://services.samples">
        <case regex="EN">
            <log level="custom">

      		  <property name="GREETING_MESSAGE" value="HELLO WORLD!!!!!!" />

   	    </log>
        </case>
        <case regex="FR">
	    <log level="custom">

      		  <property name="GREETING_MESSAGE" value="Bonjour tout le monde!!!!!!" />

   	    </log>
        </case>
	<case regex="IT">
	    <log level="custom">

      		  <property name="GREETING_MESSAGE" value="Ciao a tutti!!!!!!!" />

   	    </log>
        </case>
	<case regex="JPN">
	    <log level="custom">

      		  <property name="GREETING_MESSAGE" value="???????!!!!!!!" />

   	    </log>
        </case>
    </switch>

</sequence>

Instead of printing our "hello world" message for each and every language inside the sequence, we can create a generalized template of these actions, which will accept any greeting message (from a particular language) and log it on screen. For example, let's create the following template named "HelloWorld_Logger".

<template name="HelloWorld_Logger">
   <parameter name="message"/>
   <sequence>
        <log level="custom">
      		  <property name="GREETING_MESSAGE" expression="$func:message" />
   	</log>
   </sequence>
</template>

With our "HelloWorld_Logger" in place, the Call Template mediator can populate this template with actual hello world messages and execute the sequence of actions defined within the template like with any other sequence. This is illustrated below.

<sequence>
   <switch source="//m0:greeting/m0:lang" xmlns:m0="http://services.samples">
        <case regex="EN">
            <call-template target="HelloWorld_Logger">
		<with-param name="message" value="HELLO WORLD!!!!!!" />
	    </call-template>
        </case>
        <case regex="FR">
	    <call-template target="HelloWorld_Logger">
		<with-param name="message" value="Bonjour tout le monde!!!!!!" />
	    </call-template>
        </case>
	<case regex="IT">
	    <call-template target="HelloWorld_Logger">
		<with-param name="message" value="Ciao a tutti!!!!!!!" />
	    </call-template>
        </case>
	<case regex="JPN">
	    <call-template target="HelloWorld_Logger">
		<with-param name="message" value="???????!!!!!!!" />
	    </call-template>
        </case>
    </switch>

</sequence>

The Call Template mediator points to the same template "HelloWorld_Logger" and passes different arguments to it. In this way, sequence templates make it easy to stereotype different workflows inside the ESB profile.

Syntax

<template name="string">
   <!-- parameters this sequence template will be supporting -->
   (
   <parameter name="string"/>
   ) *
   <!--this is the in-line sequence of the template     -->
   <sequence>
        mediator+
   </sequence>
 </template>

The sequence template is a top-level element defined by the name attribute in the ESB profile configuration. Both endpoint and sequence template starts with a template element.

The parameters available to configure the Sequence Template are as follows.

Sequence template parameters can be referenced using an XPath expression defined inside the in-line sequence. For example, the parameter named "foo" can be referenced by the Property mediator (defined inside the in-line sequence of the template) in the following ways:

<property name=”fooValue” expression=”$func:foo” />

or

<property name=”fooValue” expression=”get-property('foo','func')” />

Using function scope or "?func?" in the XPath expression allows us to refer to a particular parameter value passed externally by an invoker such as the Call Template mediator.

Call Template Mediator

<call-template target="string">
   <!-- parameter values will be passed on to a sequence template -->
   (
    <!--passing plain static values -->
   <with-param name="string" value="string" /> |
    <!--passing xpath expressions -->
   <with-param name="string" value="{string}" /> |
    <!--passing dynamic xpath expressions where values will be compiled
dynamically-->
   <with-param name="string" value="{{string}}" /> |
   ) *
   <!--this is the in-line sequence of the template    -->
 </call-template>

<call-template target="HelloWorld_Logger">
	<with-param name="message" value="HELLO WORLD!!!!!!" />
</call-template>

<call-template target="HelloWorld_Logger">
	<with-param name="message" value="Bonjour tout le monde!!!!!!" />
</call-template>

<call-template target="HelloWorld_Logger">
	<with-param name="message" value="Ciao a tutti!!!!!!!" />
</call-template>

<call-template target="HelloWorld_Logger">
	<with-param name="message" value="???????!!!!!!!" />
</call-template>

<template name="HelloWorld_Logger">
   <parameter name="message"/>
   <sequence>
        <log level="custom">
      		  <property name="GREETING_MESSAGE" expression="$func:message" />
   	</log>
   </sequence>
</template>

For more information, see the following topics:

• Adding a New Sequence Template
• Editing a Sequence Template
• Deleting a Sequence Template
• Working with Templates
• Sample 751: Message Split Aggregate Using Templates