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

Methods

Modifier and Type	Method and Description
boolean	canRunApplication() Returns true if the application can run without having to stop the downloaded MHP application.
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

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

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

See Also:

Locator, ServiceDetails

getName

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

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

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

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