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

All Known Implementing Classes:
LoggingProxyDistributionListener

public interface IProxyDistributionListener

Listener for proxy distribution events. Services registered with this as their service interface will have their methods called when the distribution implementation events occur.


Method Summary
 void registered(IRemoteServiceEndpointDescription endpointDescription, IRemoteServiceContainer remoteServiceContainer, IRemoteServiceReference remoteServiceReference, org.osgi.framework.ServiceRegistration proxyServiceRegistration)
          Event that indicates that a remote service proxy has been successfully been looked up, created, and registered in the local service registry.
 void registering(IRemoteServiceEndpointDescription endpointDescription, IRemoteServiceContainer remoteServiceContainer, IRemoteServiceReference remoteServiceReference)
          Event that indicates that the given endpointDescription and remoteServiceContainer have resulted in a remoteServiceReference that will be used to register a remote service.
 void retrievingRemoteServiceReferences(IRemoteServiceEndpointDescription endpointDescription, IRemoteServiceContainer remoteServiceContainer)
          Event that indicates that an endpointDescription has been discovered and that the remote service references (specified by the endpointDescription) are being lookedup using the given remoteServiceContainer.
 void unregistered(IRemoteServiceEndpointDescription endpointDescription, org.osgi.framework.ServiceRegistration proxyServiceRegistration)
          Event that indicates that a remote service proxy has been unregistered from the local service registry.
 

Method Detail

retrievingRemoteServiceReferences

void retrievingRemoteServiceReferences(IRemoteServiceEndpointDescription endpointDescription,
                                       IRemoteServiceContainer remoteServiceContainer)
Event that indicates that an endpointDescription has been discovered and that the remote service references (specified by the endpointDescription) are being lookedup using the given remoteServiceContainer. If multiple remoteServiceContainers are found, this method will be called multiple times, each with a distinct remoteServiceContainer.

Parameters:
endpointDescription - the endpointDescription that describes the discovered endpoint that exposes some remote services. Will not be null.
remoteServiceContainer - a remote service container that has been found (via the IProxyContainerFinder) and will be used for remote lookup.

registering

void registering(IRemoteServiceEndpointDescription endpointDescription,
                 IRemoteServiceContainer remoteServiceContainer,
                 IRemoteServiceReference remoteServiceReference)
Event that indicates that the given endpointDescription and remoteServiceContainer have resulted in a remoteServiceReference that will be used to register a remote service.

Parameters:
endpointDescription - the endpointDescription that describes the discovered endpoint that exposes some remote services. Will not be null.
remoteServiceContainer - a remote service container that has been found (via the IProxyContainerFinder) and will be used for remote lookup. Will not be null.
remoteServiceReference - a remote service reference that has resulted from using the endpointDescription meta-data and remoteServiceContainer to successfully lookup this reference. Will not be null.

registered

void registered(IRemoteServiceEndpointDescription endpointDescription,
                IRemoteServiceContainer remoteServiceContainer,
                IRemoteServiceReference remoteServiceReference,
                org.osgi.framework.ServiceRegistration proxyServiceRegistration)
Event that indicates that a remote service proxy has been successfully been looked up, created, and registered in the local service registry.

Parameters:
endpointDescription - the endpointDescription that describes the discovered endpoint that exposes some remote services. Will not be null.
remoteServiceContainer - a remote service container that has been found (via the IProxyContainerFinder) and will be used for remote lookup. Will not be null.
remoteServiceReference - a remote service reference that has resulted from using the endpointDescription meta-data and remoteServiceContainer to successfully lookup this reference. Will not be null.
proxyServiceRegistration - the local ServiceRegistration that was created when the local proxy was successfully added to the service registry.

unregistered

void unregistered(IRemoteServiceEndpointDescription endpointDescription,
                  org.osgi.framework.ServiceRegistration proxyServiceRegistration)
Event that indicates that a remote service proxy has been unregistered from the local service registry.

Parameters:
endpointDescription - the endpointDescription that describes the discovered endpoint that exposes some remote services. May be null if the service is unregistered for some event other than discovery (e.g. container disconnection).
proxyServiceRegistration - the local ServiceRegistration that was created when the local proxy was successfully added to the service registry.