org.dvb.spi.selection.SelectionProviderContext Maven / Gradle / Ivy
package org.dvb.spi.selection;
/**
* Platform implementations that wish to receive notifications from a
* SelectionProvider register an instance that implements
* this interface with the SelectionProvider.
* @since MHP 1.1.3
**/
public interface SelectionProviderContext {
/**
* Called by a source when the list of services changes.
* The new list replaces any previous list.
* The services passed into this method shall be compared with the service list
* returned from the call to getServiceList when this provider was first
* registered. Where services are added, these shall be merged into the platform
* service list as defined in the description of the getServiceList method.
* Where services are removed, if the transport independent service is left with
* no transport dependent services then it shall be removed from the platform
* service list. In all cases where the platform service list changes,
* SIChangeEvents shall be generated to appropriate listeners.
*
* @param serviceReferences The ServiceReference instances
* for the available services. This array
* must not change after this method is invoked.
**/
public void serviceListChanged(ServiceReference[] serviceReferences);
/**
* Called by a source when service description information
* is available to offer that information to the platform implementation.
* The new list replaces any previous list.
*
* @param serviceReferences The ServiceReference instances
* for which descriptions are available. This array
* must not change after this method is invoked.
**/
public void serviceDescriptionAvailable(ServiceReference[] serviceReferences);
/**
* Called by a source to update the details of a service
* it supports. This includes changing the service between
* one whose location is already known and one whose
* location must be found when it is selected. It also includes
* changing the location of a service whose location is
* already known. ServiceReferences shall be matched using the
* transport independent and transport dependent names.
* @param service the new service reference
* @throws IllegalArgumentException if a service with the
* same service identifier and transport independent locator
* has not been previously returned by this source to the
* implementation
*/
public void updateService( ServiceReference service );
}