com.tplan.robot.scripting.interpret

Interface OptimizedInterpret

public interface OptimizedInterpret

Optional methods of test script interpret allowing to optimize performance, for example through a conditional compilation when there are script or dependency changes.

T-Plan Robot Enterprise, (C) 2009-2022 T-Plan Limited. All rights reserved.

Method Summary

Modifier and Type	Method and Description
boolean	compile(ScriptingContext customContext, boolean force) Compile source code of the test script.If the script is in a scripting language, the method should check the code syntax.

Method Detail

compile

boolean compile(ScriptingContext customContext,
                boolean force)
         throws InterpretErrorException

Compile source code of the test script.If the script is in a scripting language, the method should check the code syntax. If the script is in a compilable language (for example Java test scripts), the method should compile the code and make it ready for execution.

Parameters:

customContext - customized context for this validation. If the argument is null, the interpret is supposed to obtain a preinitialized context instance from the script manager through ScriptManager.createDefaultContext().

force - true to force compilation or false to indicate that if the document hasn't changed than the cached results can be used.

Returns:

true if the script compiled fine, false if there were errors. Compilation errors are to be saved as a list of SyntaxErrorException instances to the compilation context. The interpret is also supposed to fire appropriate compilation script events through the associated script manager. The context should be made available after compilation through the TestScriptInterpret.getCompilationContext() method.

Throws:

InterpretErrorException - should be thrown on an internal error or illegal interpret state. The exception message gets typically displayed or otherwise reported to the user.