Version CloverDX 5.14.1

Try-Catch Statement

Since CloverDX 5.6, you may use the try-catch statement to handle runtime errors.

The execution starts by first executing the try block. Then there is a choice:

  • If the try block completes normally,then no further action is taken, the catch block is skippedand the whole try-catch statement completes normally.

  • If the code inside the try block throws an exception,the execution jumps to the beginning of the respective catch block.It is up to you how you handle the exception there.For example, you can execute some alternative code to work around the problem that caused the exception.Or you can throw a custom error using the raiseError() function. Or you can just log the exception and have the execution complete normally.Some details about the exception can be accessed via the CTLException data structure.

For every try block, there can be only one catch block, because there is just one type of exception: CTLException. Also, there is no finally block in CTL.

try-catch statements can be nested.

Example 86. Try-Catch Statement
integer a = 123;
integer b = 0;
integer c;

try {
    c = a / b; // throws ArithmeticException
    printLog(info, c); // skipped
} catch (CTLException ex) {
    c = -1; // workaround: set the variable to -1 to indicate error
    printLog(warn, ex); // log a warning
}

CTLException is actually a data record with the following fields:

sourceRow: integer

the row of the CTL source code where the exception occurred

sourceColumn: integer

the column of the CTL source code where the exception occurred

message: string

the error message of the innermost exception - the original cause of the failure

cause: string

the type of the innermost exception, e.g. java.lang.ArithmeticException

stackTrace: list[string]

the cascade of function calls that caused the failure

exceptionTrace: list[string]

the list of exception types from the outermost to the innermost