Generic RI

Generic RI

The Generic RI uses the StormBase core and the HTML pilot. It can be run in either AWT or Swing toolkit mode:

In AWT mode, the browser runs as a simple, multi-window application with a menu bar on each window and a few navigation buttons.
In Swing mode, the interface is a multiple document interface where a single window contains one or more internal child windows (JInternalFrame) for viewing content. However, there is no menu bar and no navigation buttons.

Both modes have a garbage collection (GC) feature.

Figure 2-2 Generic RI

Starting the Generic RI

To run the Generic RI:

Ensure that JDK 1.1.8 or higher has been installed.
Add the relevant JAR files to the classpath. You need at least the following:
ri_generic.jar
ib6core.jar
ib6util.jar

To run in Swing mode, you also require ib6swing.jar.

Run java ice.browser.Main [option <value>].

If you do not specify any options, the browser runs in AWT mode and displays the default home page.

Command Line Options

Purpose

Option / Example

Result

Go to a specific Web site.

www.icesoft.com

The browser displays the ICEsoft site.

Open a file in the current directory.

index.html

The browser displays index.html.

You can specify the full URL or just a file name. If you specify just a file name, the browser builds the full URL using the current working directory and the relative path (filename) as a parameter.

Open multiple browser windows.

www.icesoft.com index.html

Two windows are opened. One displays the ICEsoft Web site, the other displays index.html in the current directory.

The first window is called icemain0, the second is icemain1, and so on.

Specify the initial size of the browser.

-w640 -h480

The size of the browser window is set to 640x480.

Run the browser in Abstract Window Toolkit (AWT) mode.

-t:awt

The browser uses the AWT toolkit. This is the default.

Run the browser in Swing mode.

-t:swing

The browser uses the Swing toolkit. This requires JDK 1.3.1 or greater, and ib6swing.jar must be on the classpath.

For example, to run a minimal configuration in AWT mode, with a start page of http://www.icesoft.com:
java -classpath ri_generic.jar;ib6core.jar;ib6util.jar ice.browser.Main
 
Starting as an Executable JAR

The ri_generic.jar file is an executable JAR, so you can also start the Generic RI with JDK 1.3.1 or greater as follows:
java -jar ri_generic.jar
 
Settings Directory

The Generic RI stores its settings in the directory <user_dir>/ICEsoft/GenericRI/, where <user_dir> is the platform-specific directory specified by the user.home system property.

Opening a Local File

To open a local file in the reference implementations, use one of the following syntaxes:

file://localhost/d:/project/test.html
file:///d:/project/test.html
file:/d:/project/test.html

The underlying Java core classes do not understand non-standard (non-W3C-compliant) URL formats.

Figure 2-3 Enhanced AWT RI

Purpose	Option / Example	Result
Go to a specific Web site.	www.icesoft.com	The browser displays the ICEsoft site.
Open a file in the current directory.	index.html	The browser displays index.html. You can specify the full URL or just a file name. If you specify just a file name, the browser builds the full URL using the current working directory and the relative path (filename) as a parameter.
Open multiple browser windows.	www.icesoft.com index.html	Two windows are opened. One displays the ICEsoft Web site, the other displays index.html in the current directory. The first window is called icemain0, the second is icemain1, and so on.
Specify the initial size of the browser.	-w640 -h480	The size of the browser window is set to 640x480.
Run the browser in Abstract Window Toolkit (AWT) mode.	-t:awt	The browser uses the AWT toolkit. This is the default.
Run the browser in Swing mode.	-t:swing	The browser uses the Swing toolkit. This requires JDK 1.3.1 or greater, and ib6swing.jar must be on the classpath.