org.dvb.internet

Interface InternetClient

All Superinterfaces:

ServiceContentHandler

All Known Subinterfaces:

EmailClient, UsenetClient, WWWBrowser

public interface InternetClient
extends 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

Methods

Modifier and Type	Method and Description
void	addInternetClientListener(InternetClientListener l) Add a listener for InternetClientEvents.
InternetClientService	getService() Get the service object which matches this internet client.
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

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

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

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

Locator[] getServiceContentLocators()

Reports the portions of the service on which this handler operates.

Specified by:

getServiceContentLocators in interface 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().

See Also:

ServiceContext.select(Locator[] components)