[dtp-dev] New methods added to support group results display

[Da-fan.Yang@xxxxxxxxxx]

Hi,
To support group results display in
SQL Results View, the following methods are added into ResultsViewAPI:

    /**
     *
Creates a sub result instance for the given parent result instance.
     *

     *
@param parentCmd the operation request instance of the parent result, can
not be null
     *
@param cmd the operation request instance, can not be null
     *
@param terminateHandler the handler to terminate the new instance, can
be null
     *
@return <code>true</code> if the creation succeeds; <code>false</code>
otherwise
     */
    public
boolean createSubInstance(OperationCommand parentCmd, OperationCommand
cmd, Runnable terminateHandler);

    /**
     *
Returns the operation request of the sub-result
     *

     *
@param parentCmd the parent operation request, can not be null
     *
@param subNum the number of the sub-instance, 0-based
     *
@return the operation request of the sub-result
     */
    public
OperationCommand getSubOperationCommand(OperationCommand parentCmd, int
subNum);

    /**
     *
Calculates the status of the result instance based on its sub-results'
status. The consumer should update the
     *
status of the parent result by invoking this method to caculate its status
     *

     *
@param command the operation command
     *
@return the status of the result instance
     */
    public
int calculateStatus(OperationCommand command);

This new feature wont break the existing
consumers, and wont affect their behaviour as well.

Best Regards & Wishes

Dafan Yang

Sybase China.
S/W Eng - Dev
Tel:0086-021-68799918-3102