Progress
Open Client
Developer’s Guide
Microsoft Internet Explorer
Internet Explorer allows you to download and install Java libraries on the user's computer. Therefore, the Open Client Runtime can be downloaded and installed once. Internet Explorer also supports versioning on these Java libraries. This allows you to update your users automatically when the Open Client Runtime is updated.
To install the Open Client Runtime from a Web page, you add an OBJECT tag to your Web page as shown in the following code:
When you do this, you must:
Modify the CODEBASE attribute to the location of the Open Client Runtime packages on the Web server from which the
.cab
file was distributed. When the Internet Explorer encounters this tag, it looks in the user’s Windows registry for an entry with the specified class ID and version. Then, it looks to see if theo4glrt.cab
file exists. If any of the above conditions are not met, the.cab
file is downloaded.NOTE: The Microsoft security classes are not available as a standalone package. You can get these security classes by downloading the latest Microsoft Java SDK fromwww.microsoft.com
.Each of the Open Client Runtime
.cab
files has its own unique class ID. This allows your application to change the types of network protocols it uses dynamically the next time the Web page is run. The version number is supplied by Progress in theo4glrt.cab
file'sopen4glrt??.inf
file and changes from release to release.Once the .
cab
file is downloaded, a dialog box opens advising the user that this code needs to be trusted, and that it is signed by Progress Software Corporation. If the user selects OK, the .zip
file is installed in theirWindows/Java/TrustedLib
directory, and all required registry keys are added or updated.The above tag also dynamically adds the
.zip
file to theTrustedClassPath
. This entry is volatile, and if the user restarts Internet Explorer, the.zip
file is no longer included in its CLASSPATH. Therefore, any time you have a Web page that uses the Open Client Runtime, you should include that OBJECT tag. Once the code is installed, there is no further action required by the user based on that OBJECT tag, even if they restart Internet Explorer. Since the run time is installed on theTrustedClassPath
, only trusted code can access it. Since you need to be trusted to open a connection to a Progress server, you are required to package your applet and proxies into a signed .cab
file. Once you have done this, you can add an applet tag like the following example:
The code attribute specifies your applet's class name that must be contained in the
.cab
file specified with thecabbase
PARAM. The value of thecabbase
PARAM should point to the.cab
file's path that contains the applet and proxy on the distribution Web server.Internet Explorer looks for the
cabbase
, and if it finds it, downloads the specified.cab
file. Since this is a signed .cab
file, a dialog box opens and displays information from your code signing certificate. Your Java code is saved in Internet Explorer's volatile cache. So, if the user restarts the Internet Explorer, your.cab
file is downloaded again.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |