org.dvb.application
Interface AppAttributes

All Known Subinterfaces:
ExtendedAppAttributes

public interface AppAttributes

The AppAttributes class is a mapping of various information about a registered application. For applications which are signalled in an AIT, the mapping between the values returned by methods in this class and the fields and descriptors of the AIT shall be as specified in the main body of the present document.

Instances of objects implementing this interface are immutable and populated before the instance is first returned to an application.

Since:
MHP1.0

Field Summary
static int DVB_HTML_application
          The DVB registered value for all DVB-HTML applications.
static int DVB_J_application
          The DVB registered value for all DVB-J applications.
 
Method Summary
 AppIcon getAppIcon()
          This method returns an object encapsulating the information about the icon(s) for the application.
 AppID getIdentifier()
          This method returns the application identifier.
 boolean getIsServiceBound()
          This method determines whether the application is bound to a single service.
 java.lang.String getName()
          This method returns the name of the application.
 java.lang.String getName(java.lang.String iso639code)
          This method returns the name of the application in the language which is specified by the parameter passed as an argument.
 java.lang.String[][] getNames()
          This method returns all the available names for the application together with their ISO 639 language code.
 int getPriority()
          This method returns the priority of the application.
 java.lang.String[] getProfiles()
          This method returns those minimum profiles required for the application to execute.
 java.lang.Object getProperty(java.lang.String index)
          The following method is included for properties that do not have explicit property accessors.
 Locator getServiceLocator()
          This method returns the locator of the Service describing the application.
 int getType()
          This method returns the type of the application (as registered by DVB).
 int[] getVersions(java.lang.String profile)
          This method returns an array of integers containing the version number of the specification required to run this application at the specified profile.
 boolean isStartable()
          This method determines whether the application is startable or not.
 boolean isVisible()
          This method determines whether the application is marked as being visible to users.
 

Field Detail

DVB_J_application

public static final int DVB_J_application
The DVB registered value for all DVB-J applications.

See Also:
Constant Field Values

DVB_HTML_application

public static final int DVB_HTML_application
The DVB registered value for all DVB-HTML applications.

See Also:
Constant Field Values
Method Detail

getType

public int getType()
This method returns the type of the application (as registered by DVB).

Returns:
the type of the application (as registered by DVB).
Since:
MHP1.0

getName

public java.lang.String getName()
This method returns the name of the application. If the default language (as specified in user preferences) is in the set of available language / name pairs then the name in that language shall be returned. Otherwise this method will return a name which appears in that set on a "best-effort basis". If no application names are signalled, an empty string shall be returned.

Returns:
the name of the application
Since:
MHP1.0

getName

public java.lang.String getName(java.lang.String iso639code)
                         throws LanguageNotAvailableException
This method returns the name of the application in the language which is specified by the parameter passed as an argument. If the language specified is not in the set of available language /name pairs then an exception shall be thrown.

Parameters:
iso639code - the specified language, encoded as per ISO 639.
Returns:
returns the name of the application in the specified language
Throws:
LanguageNotAvailableException - if the name is not available in the language specified or if the parameter passed is null
Since:
MHP1.0

getNames

public java.lang.String[][] getNames()
This method returns all the available names for the application together with their ISO 639 language code. If no application names are signalled, an array of length zero shall be returned.

Returns:
the possible names of the application, along with their ISO 639 language code. The first string in each sub-array is the ISO 639 language code. The second string in each sub-array is the corresponding application name.
Since:
MHP1.0

getProfiles

public java.lang.String[] getProfiles()
This method returns those minimum profiles required for the application to execute. Profile names shall be encoded using the same encoding specified elsewhere in this specification as input for use with the java.lang.System.getProperty method to query if a profile is supported by this platform.

For example, for implementations conforming to the first version of the specification, the translation from AIT signaling values to strings shall be as follows:

Only profiles supported by this particular MHP terminal shall be returned. Hence the method can return an array of size zero where all the profiles on which an application can execute are unknown.

Returns:
an array of Strings, each String describing a profile.
Since:
MHP1.0

getVersions

public int[] getVersions(java.lang.String profile)
                  throws IllegalProfileParameterException
This method returns an array of integers containing the version number of the specification required to run this application at the specified profile.

Parameters:
profile - a profile encoded as defined in the clause "Profile and version properties" in the main body of the present document. e.g. mhp.profile.interactive_broadcast for the interactive broadcast profile.
Returns:
an array of integers, containing the major, minor and micro values (in that order) required for the specified profile.
Throws:
IllegalProfileParameterException - thrown if the profile specified is not one of the minimum profiles required for the application to execute or if the parameter passed in is null
Since:
MHP1.0

getIsServiceBound

public boolean getIsServiceBound()
This method determines whether the application is bound to a single service.

Returns:
true if the application is bound to a single service, false otherwise.
Since:
MHP1.0

isStartable

public boolean isStartable()
This method determines whether the application is startable or not. An Application is not startable if any of the following apply. 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.

Returns:
true if an application is startable, false otherwise.
Since:
MHP1.0

getIdentifier

public AppID getIdentifier()
This method returns the application identifier.

Returns:
the application identifier
Since:
MHP1.0

getAppIcon

public AppIcon getAppIcon()
This method returns an object encapsulating the information about the icon(s) for the application.

Returns:
the information related to the icons that are attached to the application or null if no icon information is available
Since:
MHP1.0

getPriority

public int getPriority()
This method returns the priority of the application.

Returns:
the priority of the application.
Since:
MHP1.0

getServiceLocator

public Locator getServiceLocator()
This method returns the locator of the Service describing the application. For an application transmitted on a remote connection, the returned locator shall be the service for that remote connection. For applications not transmitted on a remote connection, the service returned shall be the currently selected service of the service context within which the application calling the method is running.

Returns:
the locator of the Service describing the application.
Since:
MHP1.0

getProperty

public java.lang.Object getProperty(java.lang.String index)
The following method is included for properties that do not have explicit property accessors. The naming of properties and their return values are described in the main body of the present document.

Parameters:
index - a property name
Returns:
either the return value corresponding to the property name or null if the property name is unknown or null
Since:
MHP1.0

isVisible

public boolean isVisible()
This method determines whether the application is marked as being visible to users. An inter-operable application shall honour this visibility setting. Thus a generic launching application shall list applications that are marked as visible and shall not list applications that are not marked as visible.

Returns:
true if this application is marked as being visible to users, false otherwise.
Since:
MHP1.0.3