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. To enable optional capabilities, such as HTTP support, JavaScript, extra media support, or SSL, add the required JARs as described in JAR Files (lib).

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 with Proxy Auto Configuration support.

-m:autoproxy

PAC support is enabled.

HTTP and JavaScript features must also be enabled. For more information, see PAC in the Reference Implementations.

Enable HTTP support, cookies, redirects, and authentication.

-m:http

HTTP features are enabled.

ib6http.jar must be on the classpath.

Enable SSL support.

-m:https

The HTTP and SSL features are enabled.

ib6http.jar, ib6https.jar, and icessl.jar must be on the classpath.

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.

Set the compatibility mode.

-c:ns6 or -c:ie

Sets the compatibility mode to Netscape 6 or MSIE.

Enable XSLT transformations.

-m:xalan

Pages using standard XSLT transformations can be rendered using the Xalan XSLT transformer. This requires additional JAR files. For more information, see Rendering XML Documents.

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
 
For another example, to run in Swing mode, with JavaScript enabled, MSIE emulation, a start page of http://www.google.com, and using the ICEsoft implementation of HTTP:
java -classpath ri_generic.jar;ib6core.jar;ib6util.jar;ib6extra.jar;

  ib6js.jar;ib6http.jar ice.browser.Main -m:http -t:swing

  -c:ie http://www.google.com 
 
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.

PAC Support

The Generic RI has built-in PAC support. On the command line, you set the RI-specific property com.icesoft.pac to the URL of the PAC file. The option -m:autoproxy must also be specified:
java -Dcom.icesoft.pac=file:///c:/proxy.pac ice.browser.Main 

    -m:https -m:autoproxy


 
The com.icesoft.pac property is specific to the reference implementations. If the value is anything but null, PAC is used. The value is the URL of the PAC file.

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.

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 with Proxy Auto Configuration support.	-m:autoproxy	PAC support is enabled. HTTP and JavaScript features must also be enabled. For more information, see PAC in the Reference Implementations.
Enable HTTP support, cookies, redirects, and authentication.	-m:http	HTTP features are enabled. ib6http.jar must be on the classpath.
Enable SSL support.	-m:https	The HTTP and SSL features are enabled. ib6http.jar, ib6https.jar, and icessl.jar must be on the classpath.
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.
Set the compatibility mode.	-c:ns6 or -c:ie	Sets the compatibility mode to Netscape 6 or MSIE.
Enable XSLT transformations.	-m:xalan	Pages using standard XSLT transformations can be rendered using the Xalan XSLT transformer. This requires additional JAR files. For more information, see Rendering XML Documents.