Service-Template Descriptor Element

2 min read

A service-template element defines a template for a service element, simplifying the task of deploying multiple instances of the same service definition. The template should contain a parameterized service element that is instantiated using a service-instance element.

This element may only appear as a child of an application element.

The following attributes are supported:

Attribute	Description	Required
`id`	Specifies the identifier for the service template. This identifier must be unique among all service templates in the application.	Yes

A template may declare parameters that are used to instantiate the service element. You can define a default value for each parameter. Parameters without a default value are considered mandatory and values for them must be supplied by the service-instance element.

Here is an example to demonstrate the use of this element:

XML

<icegrid>
    <application name="IceBoxApp">
        <service-template id="ServiceTemplate">
            <parameter name="name"/>
            <service name="${name}" entry="DemoService:create">
                <adapter name="${service}" .../>
            </service>
        </service-template>
        <node name="Node1">
            <icebox id="IceBoxServer" ...>
                <service-instance template="ServiceTemplate" name="Service1"/>
            </icebox>
        </node>
    </application>
</icegrid>

See Also