org.dvb.application.storage
Interface StoredServiceCreator


public interface StoredServiceCreator

This interface supports creating new Service objects representing stand-alone stored application services. Services thus created shall appear in the list of services maintained by the SIManager until removed using StoredApplicationService.remove or some MHP terminal specific mechanism. i.e. they shall be returned by filterServices both when passed an instance of ServiceTypeFilter constructed with the type StoredApplicationService.STORED_APPLICATION_SERVICE and when passed null to list all known services.

This interface shall be implemented by the object returned from javax.tv.service.SIManager.getInstance only in those MHP implementations which support stand-alone stored applications.

Since:
MHP1.1

Method Summary
 StoredApplicationService createStoredApplicationService(int organisation_id, int service_id, java.lang.String serviceName)
          Requests the platform to create a new stored application service.
 

Method Detail

createStoredApplicationService

public StoredApplicationService createStoredApplicationService(int organisation_id,
                                                               int service_id,
                                                               java.lang.String serviceName)
                                                        throws NotEnoughResourcesException,
                                                               UserRejectedInstallException,
                                                               ServiceAlreadyExistsException
Requests the platform to create a new stored application service.
Parameters:
organisation_id - the organisation_id of the organisation to whom this service belongs to
service_id - unique identifier for this service within the organisation
serviceName - a name for the service that can be displayed to the end user to identify this service
Returns:
the stored application service created
Throws:
UserRejectedInstallException - thrown if the end user rejects the installation
NotEnoughResourcesException - thrown if the MHP terminal does not have enough resources, e.g. storage space, available for the application
ServiceAlreadyExistsException - thrown if a stored application service with the same organisation_id and service_id already exists in the terminal