org.dvb.application.storage

Interface ExtendedAppAttributes

All Superinterfaces:

AppAttributes

public interface ExtendedAppAttributes
extends AppAttributes

The ExtendedAppAttributes interface provides additional attributes that are useful when application can be stored in the MHP terminal.

AppAttributes objects that are returned from the AppsDatabase shall implement this interface if and only if the terminal supports storing applications and the total amount of memory for stored services and/or cached applications is greater than zero.

Since:

MHP1.1

Field Summary

Fields inherited from interface org.dvb.application.AppAttributes

DVB_HTML_application, DVB_J_application

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canAddToStoredService() Returns true if this application is signalled as capable of being added to a stored service.
boolean	canCache() Returns true if this application is signalled as capable of being cached.
int	getCurrentVersionNumber() Returns the optional version number currently signalled for this application.
boolean	isStartable() This method determines whether the application is startable or not.
boolean	isStorageRequired() Returns true if this application is signalled as not launchable from broadcast.
boolean	isStored() Returns true if this application is currently stored or cached on the terminal.

Methods inherited from interface org.dvb.application.AppAttributes

getAppIcon, getIdentifier, getIsServiceBound, getName, getName, getNames, getPriority, getProfiles, getProperty, getServiceLocator, getType, getVersions, isVisible

Method Detail

getCurrentVersionNumber

int getCurrentVersionNumber()

Returns the optional version number currently signalled for this application. (E.g. in the AIT). If no version number is signalled, -1 shall be returned.

Returns:

the version number signalled for this application.

Since:

MHP1.1

canAddToStoredService

boolean canAddToStoredService()

Returns true if this application is signalled as capable of being added to a stored service. I.e. if this application could be added to a stored service without the InvalidApplicationException being thrown.

For broadcast applications, returns true if and only if this application is signalled as being storable and as capable of running stand alone. For applications that are part of a stored service, this function returns true.

Returns:

true if this application is signalled as capable of being added to a stored service.

Since:

MHP1.1.2

canCache

boolean canCache()

Returns true if this application is signalled as capable of being cached. I.e. if this application could be added to a cache without the InvalidApplicationException being thrown.

For broadcast applications, returns true if and only if this application is signalled as being storable. For applications that are part of a stored service, this function returns true.

Returns:

true if this application is signalled as capable of being cached.

Since:

MHP1.1.2

isStorageRequired

boolean isStorageRequired()

Returns true if this application is signalled as not launchable from broadcast. I.e. for a broadcast application this method will return true if and only if the application is signalled with an application storage descriptor where not_launchable_from_broadcast is "1". If this application is part of a stored service, this function returns true.

Note that the return value of this method does not depend on whether or not the application is currently stored or cached.

Returns:

true if and only if this application is signalled as not launchable from broadcast.

Since:

MHP1.1.2

isStored

boolean isStored()

Returns true if this application is currently stored or cached on the terminal. Returns true if and only if the application is signalled as being storable and all the files signalled as having critical priority have been stored or cached by the terminal.

Returns:

true if this application is currently stored or cached.

Since:

MHP1.1.2

isStartable

boolean isStartable()

This method determines whether the application is startable or not. An Application is not startable if any of the following apply.

• The application is transmitted on a remote connection, and either does not have an application storage descriptor, is not cached, or is not signalled as launchable completely from cache.
• The caller of the method does not have the Permissions to start it.
• if the application is signalled with a control code which is neither AUTOSTART nor PRESENT.
• if the application is signalled with an application storage descriptor where not_launchable_from_broadcast is "1", and the application is not stored or cached.

If none of the above apply, then the application is startable.

The value returned by this method does not depend on whether the application is actually running or not.

Specified by:

isStartable in interface AppAttributes

Returns:

true if an application is startable, false otherwise.

Since:

MHP1.0