|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
An interface that shall be implemented by the objects that implement javax.service.Service interface and where the MHP terminal supports storing applications. MHP terminals which do not support storing applications shall not return objects implementing this interface.
When this object represents a service that is retrieved from a network, e.g. a broadcast service, storing applications using the methods in this interface will install them in the receiver as broadcast service related stored applications.
When this object represents a stored application service, storing applications using the methods in this interface will add the application into this service.
Method Summary | |
org.dvb.application.AppID[] |
getStoredAppIDs()
Lists the AppIDs of the applications that are stored within this service. |
int |
getVersionNumber(org.dvb.application.AppID appId)
Return the version number of the stored application whose AppID is given as a parameter. |
void |
initiateApplicationInstall(org.dvb.application.AppProxy app,
boolean autoStart,
java.lang.String[] args)
Requests the MHP terminal to initiate the installation of an application into the MHP terminal. |
void |
initiateApplicationRemoval(org.dvb.application.AppID app)
Requests the MHP terminal to initiate the removal of an application stored in the MHP terminal from this service. |
Methods inherited from interface javax.tv.service.Service |
equals, getLocator, getName, getServiceType, hashCode, hasMultipleInstances, retrieveDetails |
Method Detail |
public void initiateApplicationInstall(org.dvb.application.AppProxy app, boolean autoStart, java.lang.String[] args) throws InvalidApplicationException, UserRejectedInstallException, NotEnoughResourcesException, InvalidDescriptionFileException, ApplicationDownloadException
Requests the MHP terminal to initiate the installation of an application into the MHP terminal.
Applications should be prepared for the platform consulting the end user of the MHP terminal for the permission to install the application
Note: This method is synchronous and will block until the installation is either completed or fails.
app
- an AppProxy representing the application to be
installedautoStart
- true, if the application
becomes an autostart application in the
stored application service; false, if the
application becomes a normal present
(non-autostart) application in the stored
application service. This parameter is not
used if storing a broadcast service related
application.args
- parameters to be available to the application when started.
Passing in either null or an array of size zero indicates no parameters
are to be available. These parameters shall be available to applications
when running as part of the stored application service using the
Xlet property "dvb.installer.parameters".InvalidApplicationException
- thrown if the application is not
valid for installation into this service. For a broadcast service,
only applications signalled in that service are valid.
For a stand-alone stored service, all applications identified as
able to run stand-alone in their application description file are
defined to be valid for the purposes of this exception.UserRejectedInstallException
- thrown if the end user rejects
the installationNotEnoughResourcesException
- thrown if the MHP terminal does
not have enough resources,
e.g. storage space, available
for the applicationInvalidDescriptionFileException
- thrown if the application
description file is not validApplicationDownloadException
- thrown if the downloading of the
application files was not
successfuljava.lang.SecurityException
- Thrown if the application
calling this method does not have an ApplicationStoragePermission
with action "store" or "*" for the organisation_id of the
application to be stored.
Also thrown for a stand-alone stored service if the application calling
this method does not have the same organisation_id as the application
which originally created the stand-alone stored service.public org.dvb.application.AppID[] getStoredAppIDs()
java.lang.SecurityException
- Thrown for broadcast services if the service
represented by this object is not the currently selected service of the
the service context in which the calling application is running. Thrown
for a stand-alone stored service if the application calling this method
does not have the same organisation_id as the application which originally
created the stand-alone stored service.public int getVersionNumber(org.dvb.application.AppID appId)
appId
- the AppID of the application whose version is queriedjava.lang.SecurityException
- Thrown for broadcast services if the service
represented by this object is not the currently selected service of the
the service context in which the calling application is running. Thrown
for a stand-alone stored service if the application calling this method
does not have the same organisation_id as the application which originally
created the stand-alone stored service.public void initiateApplicationRemoval(org.dvb.application.AppID app)
Requests the MHP terminal to initiate the removal of an application stored in the MHP terminal from this service.
Applications should be prepared for the platform consulting the end user of the MHP terminal for the permission to remove the application
If the application identified by the AppID passed in as a parameter is not installed in this service, the method shall fail silently.
app
- AppID of the application to be removedjava.lang.SecurityException
- thrown if the application
calling this method does not have an ApplicationStoragePermission
with action "remove" or "*" for the organisation_id of the
application to be removed.
Also thrown for a stand-alone stored service if the application calling
this method does not have the same organisation_id as the application
which originally created the stand-alone stored service.ApplicationStoragePermission
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |