org.dvb.internet

Interface WWWBrowser

All Superinterfaces:

InternetClient, ServiceContentHandler

public interface WWWBrowser
extends InternetClient

This interface provides support for the operations required on an WWW browser.

Any URLs passed to methods in this interface should correspond to the HTTP or FTP URL schemes specified in RFC 1738. Other schemes or URL formats may be supported, but these are implementation-specific and additional supported schemes should be discovered by querying the capabilities of the web browser if they are required.

Method Summary

Methods

Modifier and Type	Method and Description
void	goToURL(URL url) Direct the web browser to display the page at the specified URL.

Methods inherited from interface org.dvb.internet.InternetClient

addInternetClientListener, getService, getServiceContentLocators, removeInternetClientListener

Method Detail

goToURL

void goToURL(URL url)
             throws ClientNotRunningException

Direct the web browser to display the page at the specified URL. If the web browser is not already running, then this method will not cause the web browser to be started and the call will fail.

This is an asynchronous operation, whose success or failure will be indicated by an InternetClientSuccessEvent or InternetClientFailureEvent or one of their subclasses.

Parameters:

url - the URL to visit

Throws:

SecurityException - if the caller does not have a SocketPermission for the host part of the specified URL

IllegalArgumentException - if the URL scheme is not supported by the web browser.

ClientNotRunningException - if the client is not currently running.