jade.core

Interface ServiceFinder

public interface ServiceFinder

The ServiceFinder interface serves as an access point for kernel-level service discovery. From a service finder object one can look up a given service by name, or can directly ask for a slice of the given service.

Author:

Giovanni Rimassa - FRAMeTech s.r.l.

See Also:

Service

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	MAIN_SLICE
static java.lang.String	THIS_SLICE

Method Summary

Modifier and Type	Method and Description
Service.Slice[]	findAllSlices(java.lang.String serviceKey) Retrieves all the slices of a service currently active on this platform.
Service	findService(java.lang.String key) Looks up a platform service by name.
Service.Slice	findSlice(java.lang.String serviceKey, java.lang.String sliceKey) Looks up a specific service slice by name.

Field Detail

MAIN_SLICE

static final java.lang.String MAIN_SLICE

See Also:

Constant Field Values

THIS_SLICE

static final java.lang.String THIS_SLICE

See Also:

Constant Field Values

Method Detail

findService

Service findService(java.lang.String key)
             throws IMTPException,
                    ServiceException

Looks up a platform service by name.

Parameters:

key - The name of the service. Concrete syntax for service names is left up to concrete services.

Throws:

IMTPException

ServiceException

findSlice

Service.Slice findSlice(java.lang.String serviceKey,
                        java.lang.String sliceKey)
                 throws IMTPException,
                        ServiceException

Looks up a specific service slice by name.

Parameters:

key - A structured name identifying both a service and a slice within it. Concrete syntax for service names is left up to concrete services.

Throws:

IMTPException

ServiceException

findAllSlices

Service.Slice[] findAllSlices(java.lang.String serviceKey)
                       throws IMTPException,
                              ServiceException

Retrieves all the slices of a service currently active on this platform.

Parameters:

serviceKey - The name of the service. Concrete syntax for service names is left up to concrete services.

Returns:

An array of Service.Slice objects, containing all the slices of the requested service.

Throws:

IMTPException

ServiceException