Interface IConsumerContainerSelector
-
- All Known Implementing Classes:
ConsumerContainerSelector
public interface IConsumerContainerSelectorConsumer container selector service contract. When an ECF RemoteServiceAdmin instance is asked to import a service (i.e. viaRemoteServiceAdmin.importService(org.osgi.service.remoteserviceadmin.EndpointDescription)), the RSA first gets an instance of this service via the service registry, and then uses it to select an ECF consumer container instance by callingselectConsumerContainer(EndpointDescription).The
IRemoteServiceContainerreturned is then used on the consumer side, to actually import the remote service.If no other instances of this service have been registered, a default instance of
ConsumerContainerSelectorwill be used. Note that this default instance is registered with the lowest possible priority, so that if otherIConsumerContainerSelectorinstances are registered, they will be preferred/used over the default.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description IRemoteServiceContainerselectConsumerContainer(EndpointDescription endpointDescription)Select (or create and initialize) a consumer remote service container.
-
-
-
Method Detail
-
selectConsumerContainer
IRemoteServiceContainer selectConsumerContainer(EndpointDescription endpointDescription) throws SelectContainerException
Select (or create and initialize) a consumer remote service container.- Parameters:
endpointDescription- the endpoint description that has been discovered.- Returns:
- IRemoteServiceContainer to be used for importing the remote
service. May be
nullif not container is available for use as a consumer for the given endpointDescription. - Throws:
SelectContainerException- thrown if the host container selection or creation/configuration fails.
-
-