vrml.eai
Interface BrowserFactoryImpl

public interface BrowserFactoryImpl

Implementation of the BrowserFactory class. You usually do not use this interface directly - it is used internally by the BrowserFactory class. It contains the actual implementation of the BrowserFactory and has to be provided by the developer of the X3D browser you're using.

Method Summary

VrmlComponent	createComponent(java.lang.String[] params) Creates an AWT component that is able to render VRML content.
Browser	getBrowser(java.applet.Applet applet) Creates a new Browser object that allows to communicate with a X3D browser running as a plugin on a web page.
Browser	getBrowser(java.applet.Applet applet, java.lang.String frameName, int index) Creates a new Browser object that allows to communicate with a X3D browser running as a plugin on a web page.
Browser	getBrowser(java.net.InetAddress address, int port) Creates a new Browser object that allows to communicate with a X3D browser instance via network.

Method Detail

createComponent

VrmlComponent createComponent(java.lang.String[] params)
                              throws NotSupportedException

Creates an AWT component that is able to render VRML content.

Parameters:

params - Browser-specific parameters. These are the same parameters as used for the Browser.loadURL(java.lang.String[], java.lang.String[]) method.

Returns:

The new AWT component.

Throws:

NotSupportedException - when this way to use the X3D browser via the EAI is not supported/implemented by the concrete browser you are using.

getBrowser

Browser getBrowser(java.applet.Applet applet)
                   throws NotSupportedException,
                          NoSuchBrowserException,
                          ConnectionException

Creates a new Browser object that allows to communicate with a X3D browser running as a plugin on a web page. When there is more than one plugin on the web page, this method creates a connection to the first plugin.

Parameters:

applet - An applet that is running on the same web page as the X3D browser plugin.

Returns:

The new Browser object.

Throws:

NotSupportedException - when this way to use the X3D browser via the EAI is not supported/implemented by the concrete browser you are using.

NoSuchBrowserException - when there is no X3D browser plugin running on the web page.

ConnectionException - when the connection failed.

getBrowser

Browser getBrowser(java.applet.Applet applet,
                   java.lang.String frameName,
                   int index)
                   throws NotSupportedException,
                          NoSuchBrowserException,
                          ConnectionException

Creates a new Browser object that allows to communicate with a X3D browser running as a plugin on a web page.

Parameters:

applet - An applet that is running on the same web page as the X3D browser plugin.

frameName - The name of the frame the X3D browser plugin is running in.

index - The index of the X3D browser plugin on the web page, starting at 0. This allows to specify which plugin to use when there is more than one X3D browser plugin on the web page.

Returns:

The new Browser object.

Throws:

NotSupportedException - when this way to use the X3D browser via the EAI is not supported/implemented by the concrete browser you are using.

NoSuchBrowserException - when there is no X3D browser plugin running on the web page.

ConnectionException - when the connection failed.

getBrowser

Browser getBrowser(java.net.InetAddress address,
                   int port)
                   throws NotSupportedException,
                          NoSuchBrowserException,
                          java.net.UnknownHostException,
                          ConnectionException

Creates a new Browser object that allows to communicate with a X3D browser instance via network.

Parameters:

address - The address of the machine the X3D browser is running on.

port - The port number the X3D browser is listening on for connections.

Returns:

The new Browser object.

Throws:

NotSupportedException - when this way to use the X3D browser via the EAI is not supported/implemented by the concrete browser you are using.

NoSuchBrowserException - when there is no browser running at the specified address.

java.net.UnknownHostException - when the address parameter is invalid.

ConnectionException - when the connection failed.