org.eclipse.ecf.osgi.services.distribution
Interface IHostContainerFinder

All Known Implementing Classes:

DefaultHostContainerFinder

public interface IHostContainerFinder

Service interface for customizing the finding of host remote service containers. Services registered with this interfaces will be consulted when a remote service host is registered, in order to select and/or connect IRemoteServiceContainer instances to use to publish remote references.

Method Summary

IRemoteServiceContainer[]

findHostContainers(org.osgi.framework.ServiceReference serviceReference, java.lang.String[] serviceExportedInterfaces, java.lang.String[] serviceExportedConfigs, java.lang.String[] serviceIntents) Find remote service containers.

Method Detail

findHostContainers

IRemoteServiceContainer[] findHostContainers(org.osgi.framework.ServiceReference serviceReference,
                                             java.lang.String[] serviceExportedInterfaces,
                                             java.lang.String[] serviceExportedConfigs,
                                             java.lang.String[] serviceIntents)

Find remote service containers. Implementers of this service will be consulted when a remote service is registered, so that they may provide access to zero or more IRemoteServiceContainer instances to use for distribution and remote service publication and discovery.

Parameters:

serviceReference - the ServiceReference of the remote service service registration.

serviceExportedInterfaces - The exported interfaces specified by the remote service registration. These are the values associated with the required service property IDistributionConstants.SERVICE_EXPORTED_INTERFACES as per chapter 13 of the OSGi 4.2 compendium specification. Will not be null.

serviceExportedConfigs - The exported configuration types specified by the remote service registration. These are the values associated with the optional service property IDistributionConstants.SERVICE_EXPORTED_CONFIGS as per chapter 13 of the OSGi 4.2 compendium specification. May be null.

serviceIntents - The service intents specified by the remote service registration. These are the values associated with the union of the service properties IDistributionConstants.SERVICE_INTENTS, IDistributionConstants.SERVICE_EXPORTED_INTENTS, and IDistributionConstants.SERVICE_EXPORTED_INTENTS_EXTRA. May be null.

Returns:

IRemoteServiceContainer[] the ECF remote service containers that should distribute and publish the remote service (specified by the serviceReference) for remote access.