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

All Known Implementing Classes:

DefaultProxyContainerFinder

public interface IProxyContainerFinder

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

Since:

1.1

Method Summary

IRemoteServiceContainer[]

findProxyContainers(IServiceID serviceID, IRemoteServiceEndpointDescription endpointDescription) Find remote service containers.

Method Detail

findProxyContainers

IRemoteServiceContainer[] findProxyContainers(IServiceID serviceID,
                                              IRemoteServiceEndpointDescription endpointDescription)

Find remote service containers. Implementers of this service will be consulted when a remote proxy is discovered, so that they may provide access to zero or more IRemoteServiceContainer instances to use for proxy creation and local publication in the service registry.

Parameters:

serviceID - the service ID exposed by the discovery provider. Will not be null.

endpointDescription - the endpoint description created from the discovered remote service meta data. This endpointDescription may be used to decide what IRemoteServiceContainer[] to return, as well as whether or not to connect the IContainer to the targetID (provided by IRemoteServiceEndpointDescription.getConnectTargetID() . Will not be null.

Returns:

IRemoteServiceContainer[] the remote service containers that should be used to get remote service references for the remote service described by the endpointDescription. If no containers are relevant, then an empty array should be returned rather than null.