Progress
Open Client
Developer’s Guide
SubAppObjects
Each SubAppObject represents the encapsulation of a particular business function deployed at a particular AppServer. It differs from an AppObject only in the fact that it does not establish its own connection to an AppServer but shares the one from its associated AppObject.
The associated AppObject defines a class factory method for creating each SubAppObject that shares its AppServer connection. This method exchanges no communications with the AppServer. Rather, it only performs operations to instantiate the SubAppObject on the client.
Methods
A SubAppObject has the following types of methods:
- Remote 4GL — Invoke non-persistent procedures, internal procedures, or user-defined functions on the AppServer.
- Procedure Class Factory — Create ProcObjects that share the AppServer connection from the associated AppObject and run an external procedure on the AppServer persistently.
- SDOResultSet Class Factory— (Java only) A built-in method that creates a predefined ProcObject, SDOResultSet. SDOResultSet provides Java client access to a specified remote Progress SmartDataObject as an extended JDBC 2 ResultSet. For more information, see Using SmartDataObjects From Java Clients."
- Common — Provide management functions.
Example Java SubAppObject
Example 4–2 shows a partial sample Java class definition for a SubAppObject,
Tax
. This proxy contains a Remote 4GL method to runSetStatus.p
and a Class Factory method that runsTaxInfo.p
on the AppServer persistently.
Example 4–2: Java Tax ClassFor more information on the three types of methods in a SubAppObject, see the "Understanding Proxy Object Methods" section in this chapter.
Example ActiveX SubAppObject
The following Visual Basic subroutines and functions comprise the definition for a sample ActiveX SubAppObject,
Tax
, where each method appears as it is displayed by the VB Object Browser:For more information on the three types of methods in a SubAppObject, see the "Understanding Proxy Object Methods" section in this chapter.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |