The Open Client Runtime provides three Java classes that you need to access a remote SmartDataObject from a Java application. These, and other supporting classes, are provided in the com.progress.open4gl package:

  • SDOResultSet — This is an extended subset of the JDBC 2 ResultSet interface, which provides access to a SmartDataObject. Because all instances of a SmartDataObject present the same ABL API, the one SDOResultSet class allows you to access any such instance.

    SDOResultSet allows you to access only the default SmartDataObject API generated by the OpenEdge AppBuilder. If you need to access custom programmer extensions to this API, you must access the SmartDataObject API directly.

  • AppObject or SubAppObject — These objects allow you to create an SDOResultSet (using _createSDOResultSet()) to access any remote SmartDataObject. You can access the SDOResultSet object from the following proxy objects:
    • Any standard AppObject or SubAppObject you generate in ProxyGen
    • A prebuilt com.progress.open4gl.SDOAppObject proxy that is installed as part of Open Client Runtime

    Using a standard AppObject or SubAppObject allows you to map other application server procedures besides SmartDataObjects into the generated proxy. The SDOAppObject installed with OpenEdge is a complete proxy that allows you to access any SmartDataObject without having to build a proxy in ProxyGen. Essentially, it is a complete AppObject built to access only SDOResultSet objects.

    Thus, if you need to access only SmartDataObjects on the application server and no other application server procedures, you can use this SDOAppObject as is. If you need to access other ABL procedures on the application server in addition to the SmartDataObject, you also can use any AppObject or SubAppObject generated with ProxyGen to access any SmartDataObject.

  • SDOParameters — This is an object you can pass to the SDOResultSet constructor through the _createSDOResultSet() method. SDOParameters allows you to modify the default behavior of the SDOResultSet instance. You can create an SDOParameters object using its constructor with no parameters (SDOParameters( )) and initialize it using its methods.