org.dvb.internet
Interface InternetClient

All Superinterfaces:
javax.tv.service.selection.ServiceContentHandler
All Known Subinterfaces:
EmailClient, UsenetClient, WWWBrowser

public interface InternetClient
extends javax.tv.service.selection.ServiceContentHandler

Base interface for the internet clients. Access to those methods common to all running instances of the client (e.g. operations on bookmark lists) are all carried out through the service objects associated with the InternetClient object in question. These are accessed using the getService() method.


Method Summary
 void addInternetClientListener(InternetClientListener l)
          Add a listener for InternetClientEvents.
 InternetClientService getService()
          Get the service object which matches this internet client.
 javax.tv.locator.Locator[] getServiceContentLocators()
          Reports the portions of the service on which this handler operates.
 void removeInternetClientListener(InternetClientListener l)
          Remove a listener for InternetClientEvents.
 

Method Detail

getService

public InternetClientService getService()
Get the service object which matches this internet client. In the case of a web browser, for example, this would be an instance of the WWWBrowserService class.
Returns:
the service which matches the InternetClient object.

addInternetClientListener

public void addInternetClientListener(InternetClientListener l)
Add a listener for InternetClientEvents. If the listener is already registered, or the client is not running, then calls to this method have no effect.
Parameters:
l - the listener to be added.

removeInternetClientListener

public void removeInternetClientListener(InternetClientListener l)
Remove a listener for InternetClientEvents. If the listener is not registered, or the client is not running, then calls to this method have no effect.
Parameters:
l - the listener to be added.

getServiceContentLocators

public javax.tv.locator.Locator[] getServiceContentLocators()
Reports the portions of the service on which this handler operates.
Specified by:
getServiceContentLocators in interface javax.tv.service.selection.ServiceContentHandler
Returns:
An array of length 1, containing the locator representing the internet client. This shall be the same locator returned by calls to getService().getLocator().