Interface BrowserFactoryImpl

public interface BrowserFactoryImpl

Implementation of factory class for obtaining references to browser instances.


Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).

The factory implementation interface for obtaining references to browser instances.

Any implementation of a X3D browser that wishes to provide their own customised version of the browser factory should must subclass this class. In particular this is useful if the implementation needs to stay within the package defined by the application for other reasons.

A default implementation of this class is the DefaultBrowserFactoryImpl which is package access only.

*

See Also:

• SAI Java Specification: B.5.2 BrowserFactory
• X3D Tooltips: BrowserFactoryImpl
• X3D Scene Authoring Hints

Method Summary

Modifier and Type	Method	Description
X3DComponent	createComponent(Map<String,Object> params)	Create a X3D browser that can be used as an AWT component.
ExternalBrowser	getBrowser(InetAddress address, int port)	Get a reference to a browser that is located on a remote machine.

Method Details

createComponent

X3DComponent createComponent(Map<String,Object> params)
                      throws NotSupportedException

Create a X3D browser that can be used as an AWT component. The component returned is guaranteed to be an instance of X3DComponent.

Parameters:

params - Parameters to control the look and feel.

Returns:

The component browser initialised to be empty.

Throws:

NotSupportedException - The implementation does not support this type of browser.

See Also:

• X3DComponent

getBrowser

ExternalBrowser getBrowser(InetAddress address,
 int port)
                    throws NotSupportedException,
NoSuchBrowserException,
UnknownHostException,
ConnectionException

Get a reference to a browser that is located on a remote machine. This a server application to send scene updates to a number of client browsers located on remote machines. If there are a number of browsers running on a remote machine, they can be differentiated by the port number they are listening on.

There is no default port number for X3D browsers.

Parameters:

address - The address of the machine to connect to

port - The port number on that machine to connect to.

Returns:

A reference to the Browser implementation

Throws:

NotSupportedException - The implementation does not support this type of X3D browser.

NoSuchBrowserException - Could not locate a X3D browser on the same page as the applet.

UnknownHostException - Could not find the machine named in the address.

ConnectionException - An error occurred during the connecting process