Parameterized Java Method Calls

As long as test code is parameterized in the Java test class, it may be sufficient to call simple Java methods that do not take parameters or have return values. Often however it is desirable to customize test code in BDL and execute it in Java. Attribute functions can be used to pass parameters from BDL to Java code, but with Silk Performer it is also possible to call test methods in a Java test class that expect or return simple or complex parameters.

To call a test method that takes parameters, use the following function calls prior to invoking the test method:

• JavaSetNumber( in hObject : number, in nParam : number, in sType : string optional );
• JavaSetBoolean( in hObject : number, in bParam : boolean );
• JavaSetFloat( in hObject: number, in fParam : float, in sType : string optional );
• JavaSetObject( in hObject : number, in hParam : number, in sType : string optional );
• JavaSetString( in hObject : number, in sParam : string allownull );
• JavaSetChar( in hObject : number, in nParam : number );
• JavaSetByteArray( in hObject : number, in sParam : string allownull, in nLen : number optional );
• JavaSetCharArray( in hObject : number, in sParam : string allownull, in nLen : number optional );

The first parameter of the functions must be a valid handle on a Java object, usually the handle on the Java test object that was retrieved in the TInit transaction.

The data type of the first parameter of the Java test method must match the first usage of the JavaSet* function, and so on. In parameters are only valid for the following method call on a referenced object.

To call a test method that returns a parameter, use the following function calls after invoking the test method:

• JavaGetBoolean( in hObject: number ): boolean;
• JavaGetFloat( in hObject: number ): float;
• JavaGetNumber( in hObject: number ): number;
• JavaGetObject( in hObject : number ): number;
• JavaGetString( in hObject : number, out sBuffer : string, in nBufLen : number optional );
• JavaGetChar( in hObject: number ): number;

Here is an example parameterized Java method call:

dcltrans
  transaction TMyJavaTrans
  var
    fValue : float;
  begin                            
    // set the first parameter
    JavaSetString(hTestObj, "1");
    // set the second parameter
    JavaSetNumber(hTestObj, 1);
    // invoke the method
    JavaCallMethod(hTestObj, "doFoo");
    // retrieve the result
    fValue := JavaGetFloat(hTestObj);
    Print("doFoo returned "+String(fValue));
  end TMyJavaTrans;