Service Descriptor Element

A service element defines an IceBox service. It typically contains at least one adapter element, and may supply additional information such as configuration properties.

This element may only appear as a child of an icebox element or a service-template element.

The following attributes are supported:

Attribute

Description

Required

entry

Specifies the entry point of this service.

Yes

name

Specifies the name of this service. Within the service, child elements can refer to its name using the reserved variable ${service}.

Yes

An optional nested description element provides free-form descriptive text.

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

XML
<icebox id="MyIceBox" ...>
    <service name="Service1" entry="service1:Create">
        <description>A description of this service.</description>
        <property name="ServiceName" value="${service}"/>
        <adapter name="MyAdapter" id="${service}Adapter" .../>
    </service>
    <service name="Service2" entry="service2:Create"/>
</icebox>
See Also