org.dvb.internet
Interface WWWBrowser

All Superinterfaces:
InternetClient, javax.tv.service.selection.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
 void goToURL(java.net.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

public void goToURL(java.net.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:
java.lang.SecurityException - if the caller does not have a SocketPermission for the host part of the specified URL
java.lang.IllegalArgumentException - if the URL scheme is not supported by the web browser.
ClientNotRunningException - if the client is not currently running.