Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

RealityV15.1Online Documentation (MoTW) Revision 7

Extending the RSC Class (JReal) (extending_rsc.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

Extending the RSC Class

This section of the help includes the code for a class Sample which extends the RSC class to access the Remote Basic subroutine RW.SAMPLE.

It also includes the code for a class Main which creates an instance of Sample to run RW.SAMPLE, passing in the parameters required by RW.SAMPLE and receiving these parameters which are simply returned by the subroutine.

Sample

Sample extends RSC to provide a subroutine specific class.
A program creating an instance of Sample must supply a reference to an RSCConnectionobject.
Sample calls RSC, passing the reference to the RSCConnection object and the name of the Remote Basic subroutine to be accessed, RW.SAMPLE.
Sample's local execute() method overrides RSC's execute() method and calls RW.SAMPLE, passing the parameters as a string array.
RW.SAMPLE returns these two parameters (see example code for rwdemo). Sample reads them into a string array called result.

Main

Main sets up string variables with the host name, port number, user-id and Reality account name that configure the connection to the required Reality database. These are used to create reality, a reference to an RSCConnection object. The connect() method is called to establish the connection.
Main creates sam, a reference to a Sample object, and passes in the reality reference.
Main then calls sam.execute() to execute RW.SAMPLE, passing the two parameters param1 and param2.
The contents of the result array returned by sam are displayed.
Main calls reality.disconnect() to disconnect from the Reality database.