Service Descriptor Element

2 min read

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