edu.stanford.ejalbert.launching
Interface IBrowserLaunching

All Known Implementing Classes:

DefaultWindowsBrowserLaunching, MacOs2_0BrowserLaunching, MacOs2_1BrowserLaunching, MacOs3_0BrowserLaunching, MacOs3_1BrowserLaunching, MacOsBrowserLaunching, SunOSBrowserLaunching, UnixNetscapeBrowserLaunching, Windows2000BrowserLaunching, Windows9xBrowserLaunching, WindowsBrowserLaunching, WindowsNtBrowserLaunching

public interface IBrowserLaunching

Author:

Markus Gebhard

Field Summary

static java.lang.String	BROWSER_DEFAULT Identifier for the system's default browser.
static java.lang.String	PROTOCOL_FILE
static java.lang.String	PROTOCOL_HTTP
static java.lang.String	PROTOCOL_MAILTO

Method Summary

java.util.List	getBrowserList() Returns a list of browsers to be used for browser targetting.
void	initialize() Performs any initialization needed for the particular O/S.
void	openUrl(java.lang.String urlString) Opens the passed url in the system's default browser.
void	openUrl(java.lang.String browser, java.lang.String urlString) Allows user to target a specific browser.

Field Detail

PROTOCOL_HTTP

static final java.lang.String PROTOCOL_HTTP

See Also:

Constant Field Values

PROTOCOL_FILE

static final java.lang.String PROTOCOL_FILE

See Also:

Constant Field Values

PROTOCOL_MAILTO

static final java.lang.String PROTOCOL_MAILTO

See Also:

Constant Field Values

BROWSER_DEFAULT

static final java.lang.String BROWSER_DEFAULT

Identifier for the system's default browser.

See Also:

Constant Field Values

Method Detail

initialize

void initialize()
                throws BrowserLaunchingInitializingException

Performs any initialization needed for the particular O/S.

Throws:

BrowserLaunchingInitializingException

openUrl

void openUrl(java.lang.String urlString)
             throws UnsupportedOperatingSystemException,
                    BrowserLaunchingExecutionException,
                    BrowserLaunchingInitializingException

Opens the passed url in the system's default browser.

Parameters:

urlString - String

Throws:

UnsupportedOperatingSystemException

BrowserLaunchingExecutionException

BrowserLaunchingInitializingException

openUrl

void openUrl(java.lang.String browser,
             java.lang.String urlString)
             throws UnsupportedOperatingSystemException,
                    BrowserLaunchingExecutionException,
                    BrowserLaunchingInitializingException

Allows user to target a specific browser. The names of potential browsers can be accessed via the getBrowserList method.

If the call to the requested browser fails, the code will fail over to the default browser.

Parameters:

browser - String

urlString - String

Throws:

UnsupportedOperatingSystemException

BrowserLaunchingExecutionException

BrowserLaunchingInitializingException

getBrowserList

java.util.List getBrowserList()

Returns a list of browsers to be used for browser targetting. This list will always contain at least one item: BROWSER_DEFAULT.

Returns:

List