org.dvb.application.storage
Interface StoredApplicationService

All Superinterfaces:
ApplicationStorage, javax.tv.service.Service

public interface StoredApplicationService
extends javax.tv.service.Service, ApplicationStorage

Defines the information about a stored application service.

Stored application services can be created by applications that have a permission to store applications for an organisation_id.

Stored application services are uniquely identified within the terminal by the combination of the organisation_id and service_id.

Since:
MHP1.1

Field Summary
static javax.tv.service.ServiceInformationType STORED
          The service information is from storage
static javax.tv.service.ServiceType STORED_APPLICATION_SERVICE
          The service type for a stored application
 
Method Summary
 javax.tv.locator.Locator getLocator()
          Gets the Locator for this stored application service.
 java.lang.String getName()
          Returns the name of the stored application service as defined when the stored application service was created.
 int getOrganisationId()
          Return the organisation id of this stored application service
 int getServiceId()
          Return the service id of this stored application service
 javax.tv.service.ServiceInformationType getServiceInformationType()
          Returns the service information format of this object.
 javax.tv.service.ServiceType getServiceType()
          Returns the type of this service.
 boolean hasMultipleInstances()
          Indicates whether the service represented by this Service is available on multiple transports.
 void removeService()
          Request the removal of the whole stored application service from the terminal.
 javax.tv.service.SIRequest retrieveDetails(javax.tv.service.SIRequestor requestor)
          This method retrieves additional information about the service.
 
Methods inherited from interface javax.tv.service.Service
equals, hashCode
 
Methods inherited from interface org.dvb.application.storage.ApplicationStorage
getStoredAppIDs, getVersionNumber, initiateApplicationInstall, initiateApplicationRemoval
 

Field Detail

STORED

public static final javax.tv.service.ServiceInformationType STORED
The service information is from storage

STORED_APPLICATION_SERVICE

public static final javax.tv.service.ServiceType STORED_APPLICATION_SERVICE
The service type for a stored application
See Also:
javax.tv.service.navigation.ServiceTypeFilter
Method Detail

getOrganisationId

public int getOrganisationId()
Return the organisation id of this stored application service
Returns:
the organisation id of this stored application service

getServiceId

public int getServiceId()
Return the service id of this stored application service
Returns:
the service id of this stored application service

getLocator

public javax.tv.locator.Locator getLocator()
Gets the Locator for this stored application service. This locator is opaque and platform specific. It is not required to be an instance of any public locator class in the platform.
Specified by:
getLocator in interface javax.tv.service.Service
Returns:
a locator for this stored application service

getName

public java.lang.String getName()
Returns the name of the stored application service as defined when the stored application service was created.
Specified by:
getName in interface javax.tv.service.Service
Returns:
the name of the stored application service

getServiceInformationType

public javax.tv.service.ServiceInformationType getServiceInformationType()
Returns the service information format of this object. This shall always return STORED.
Returns:
the service information format

getServiceType

public javax.tv.service.ServiceType getServiceType()
Returns the type of this service. For stored application services, this method shall always return STORED_APPLICATION_SERVICE.
Specified by:
getServiceType in interface javax.tv.service.Service
Returns:
service type of this service

hasMultipleInstances

public boolean hasMultipleInstances()
Indicates whether the service represented by this Service is available on multiple transports. For stored application services, this shall always return false.
Specified by:
hasMultipleInstances in interface javax.tv.service.Service
Returns:
false

removeService

public void removeService()
Request the removal of the whole stored application service from the terminal. Removal of the service results in the removal of all the applications from within that service.

retrieveDetails

public javax.tv.service.SIRequest retrieveDetails(javax.tv.service.SIRequestor requestor)
This method retrieves additional information about the service. This shall result in failure with the SIRequestFailureType DATA_UNAVAILABLE.
Specified by:
retrieveDetails in interface javax.tv.service.Service
Parameters:
requestor - The SIRequestor to be notified when this operation completes.
Returns:
A SIRequest object identifying this request.