javax.slee.facilities
Interface ServiceLookupFacility

public interface ServiceLookupFacility

The Service Lookup Facility is used by resource adaptors to obtain information about the event types a service may received. A resource adaptor may obtain an instance of the Event Lookup Facility via the ResourceAdaptorContext.getServiceLookupFacility() method.

Since:

SLEE 1.1

Method Summary

ReceivableService

getReceivableService(ServiceID service) Get information about the event types that a service may receive.

Method Detail

getReceivableService

ReceivableService getReceivableService(ServiceID service)
                                       throws java.lang.NullPointerException,
                                              UnrecognizedServiceException,
                                              FacilityException

Get information about the event types that a service may receive.

The SLEE need only provide a resource adaptor with information about the event types that the resource adaptor may fire. Generally this is limited to the resource adaptor types implemented by the resource adaptor. However a resource adaptor may be able to fire events of any type if its deployment descriptor has disabled this limitation, and in such cases the Service Lookup Facility should provide the resource adaptor with information about all the event types that may be received by the service.

This method is a non-transactional method.

Parameters:

service - the service component identifier for the service.

Returns:

a ReceivableService object that contains information about the event types that may be received by the service.

Throws:

java.lang.NullPointerException - if service is null.

UnrecognizedServiceException - if service does not identify a service installed in the SLEE.

FacilityException - if the ReceivableService object could not be obtained due to a system-level failure.