org.dvb.internet
Interface InternetClientService

All Superinterfaces:
Service
All Known Subinterfaces:
EmailClientService, UsenetClientService, WWWBrowserService

public interface InternetClientService
extends Service

The base class for the interface to resident applications that are supported by the internet access profile.

The lifecycle of an application which implements this interface or its subclasses is for a broadcast service. The application is started by selecting the appropriate service (using the Locator object returned by calls to getLocator() ). If this service is selected in the service context which contains the executing application, any currently presented content will be stopped and the application will be destroyed before the client is launched. Calling destroy() or stop() on the service context in which the client is running will cause the client to be terminated.

Methods in this API will not affect the lifecycle of the calling application.


Method Summary
 boolean canRunApplication()
          Returns true if the application can run without having to stop the downloaded MHP application.
 java.lang.String getName()
          Returns a short service name or an acronym.
 ServiceType getServiceType()
          Returns the type of this service.
 InternetClientService[] getSupportedClientServices()
          Returns all InternetClientServices supported by the same application as this one.
 boolean hasMultipleInstances()
          This method indicates whether the service represented by this Service is available on multiple transports.
 SIRequest retrieveDetails(SIRequestor requestor)
          This method will always fail when called for an InternetClient.
 
Methods inherited from interface javax.tv.service.Service
equals, getLocator, hashCode
 

Method Detail

canRunApplication

public boolean canRunApplication()
Returns true if the application can run without having to stop the downloaded MHP application.

Returns:
true if the application can be run without stopping the calling application, or false otherwise.

retrieveDetails

public SIRequest retrieveDetails(SIRequestor requestor)
This method will always fail when called for an InternetClient. The requestor will always be notified of a failure of type DATA_UNAVAILABLE.

Specified by:
retrieveDetails in interface Service
Parameters:
requestor - - The SIRequestor to be notified when this retrieval operation completes.
Returns:
An SIRequest object identifying the request

getName

public java.lang.String getName()
Returns a short service name or an acronym. In the case of subclasses of InternetClient, the returned value is implementation dependent

Specified by:
getName in interface Service
Returns:
A string representing this service's short name.

hasMultipleInstances

public boolean hasMultipleInstances()
This method indicates whether the service represented by this Service is available on multiple transports. This method has no effect in the case of an InternetClient

Specified by:
hasMultipleInstances in interface Service
Returns:
FALSE always for InternetClient instances

getServiceType

public ServiceType getServiceType()
Returns the type of this service. In the case of internet clients, one of the service types defined in the InternetServiceType class shall be returned.

Specified by:
getServiceType in interface Service
Returns:
The service type of this Service.

getSupportedClientServices

public InternetClientService[] getSupportedClientServices()
Returns all InternetClientServices supported by the same application as this one. This InternetClientService is included in the array.

Returns:
an array of InternetClientServices