Remote Data Objects (RDO) Sample

This article has four sections:

To see:

Overview of the sample

The RDOSample sample creates a simple database browser using RDO.

About the server

RDO is a COM interface to ODBC (Open Database Connectivity). ODBC is an open, vendor-neutral interface for database connectivity.

About the sample

This sample is a simple RDO browser. It only uses a very small subset of the available interface. Specifically, the sample is a database browser that permits the user to see the rows in a table. There are only four navigation options:

The sample is purposefully simple so that the interaction of Java™ and RDO can be seen more clearly.

About security

COM components can access any system resources. As such, they are both very powerful and potentially very dangerous. In the Java virtual machine (VM) in Microsoft® Internet Explorer 3.0 only trusted class files can use COM components. Class files from digitally signed CAB files are trusted.

If the HTML file is run from Microsoft Developer Studio, the class files are also trusted. This can be very helpful during applet development. However, to deliver your applet to other users, you must put it in a signed CAB file.

When run as an application, the class file must already be on your machine. When run as an applet, the class file may be downloaded to your machine. There is a potential security threat running downloaded software. To run a Java applet that uses COM components, the applet code must be trusted. For more information on trusted class files, see the CabAndSign sample.

Return to the top of this article.

How to use this sample

To run the RDOSample sample:

  1. Register an ODBC data source.
    See     Registering an ODBC Data Source.
  2. Create a Java interface for the COM component.
    See Creating a Java Interface for a COM component.
  3. In Developer Studio, build the applet.
  4. In Developer Studio, run the applet.
    If this is the first time you have run the applet, Developer Studio will prompt you for the name of the class. Type simplerdo.

Note: This sample requires database support. Database support is a custom installation option. If you did not select database support during installation, please install again, selecting the Custom installation option so you can choose database support.

Return to the top of this article.

Troubleshooting this sample

If you get the error message ComFailException: (800a9c42):

If you get the error message java.lang.VerifyError:

If you get the error message ClassNotFoundException:

If you get the error message UnsatisfiedLinkError:

Return to the top of this article.

Files in this sample

This sample includes the following files.

Project files:

Support files:

Return to the top of this article.