| org.eclipse.jdt.debug.eval.IAstEvaluationEngine
All known Subclasses: org.eclipse.jdt.internal.debug.eval.ast.engine.ASTEvaluationEngine,
| IAstEvaluationEngine | | public interface IAstEvaluationEngine extends IEvaluationEngine(Code) | | An evaluation engine that performs evaluations by
interpreting abstract syntax trees. An AST evaluation engine
is capable of creating compiled expressions that can be
evaluated multiple times in a given runtime context.
Clients are not intended to implement this interface.
since:
2.0 |
| Method Summary | |
| public void | evaluateExpression(ICompiledExpression expression, IJavaStackFrame frame, IEvaluationListener listener, int evaluationDetail, boolean hitBreakpoints)
Asynchronously evaluates the given expression in the context of
the specified stack frame, reporting the result back to the given listener.
The thread is resumed from the location at which it
is currently suspended to perform the evaluation. | | public void | evaluateExpression(ICompiledExpression expression, IJavaObject object, IJavaThread thread, IEvaluationListener listener, int evaluationDetail, boolean hitBreakpoints)
Asynchronously evaluates the given expression in the context of
the specified type, reporting the result back to the given listener.
The expression is evaluated in the context of the Java
project this evaluation engine was created on. | | public ICompiledExpression | getCompiledExpression(String expression, IJavaStackFrame frame)
Synchronously generates a compiled expression from the given expression
in the context of the specified stack frame. | | public ICompiledExpression | getCompiledExpression(String expression, IJavaObject object)
Synchronously generates a compiled expression from the given expression
in the context of the specified object. | | public ICompiledExpression | getCompiledExpression(String expression, IJavaReferenceType type)
Synchronously generates a compiled expression from the given expression
in the context of the specified type. |
| evaluateExpression | | public void evaluateExpression(ICompiledExpression expression, IJavaStackFrame frame, IEvaluationListener listener, int evaluationDetail, boolean hitBreakpoints) throws DebugException(Code) | | Asynchronously evaluates the given expression in the context of
the specified stack frame, reporting the result back to the given listener.
The thread is resumed from the location at which it
is currently suspended to perform the evaluation. When the evaluation
completes, the thread will be suspended at this original location.
The thread runs the evaluation with the given evaluation detail
(@see IJavaThread#runEvaluation(IEvaluationRunnable, IProgressMonitor, int)).
Compilation and runtime errors are reported in the evaluation result.
Parameters:
expression - expression to evaluate
Parameters:
frame - the stack frame context in which to run theevaluation.
Parameters:
listener - the listener that will receive notificationwhen/if the evaluation completes
Parameters:
evaluationDetail - one of DebugEvent.EVALUATION orDebugEvent.EVALUATION_IMPLICIT
Parameters:
hitBreakpoints - whether or not breakpoints should be honoredin the evaluation thread during the evaluation. If false,breakpoints hit in the evaluation thread will be ignored.
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
- The associated thread is not currently suspended
- The stack frame is not contained in the debug targetassociated with this evaluation engine
- The associated thread is suspended in the middle ofan evaluation that has not completed. It is not possibleto perform nested evaluations
|
| evaluateExpression | | public void evaluateExpression(ICompiledExpression expression, IJavaObject object, IJavaThread thread, IEvaluationListener listener, int evaluationDetail, boolean hitBreakpoints) throws DebugException(Code) | | Asynchronously evaluates the given expression in the context of
the specified type, reporting the result back to the given listener.
The expression is evaluated in the context of the Java
project this evaluation engine was created on. If the
expression is determined to have no errors, the expression
is evaluated in the thread associated with the given
stack frame. When the evaluation completes, the thread
will be suspended at this original location.
The thread runs the evaluation with the given evaluation detail
(@see IJavaThread#runEvaluation(IEvaluationRunnable, IProgressMonitor, int)).
Compilation and runtime errors are reported in the evaluation result.
Parameters:
expression - the expression to evaluate
Parameters:
object - the 'this' context for the evaluation
Parameters:
thread - the thread in which to run the evaluation,which must be suspended
Parameters:
listener - the listener that will receive notificationwhen/if the evaluation completes
Parameters:
evaluationDetail - one of DebugEvent.EVALUATION orDebugEvent.EVALUATION_IMPLICIT
Parameters:
hitBreakpoints - whether or not breakpoints should be honoredin the evaluation thread during the evaluation. If false,breakpoints hit in the evaluation thread will be ignored.
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
- The associated thread is not currently suspended
- The stack frame is not contained in the debug targetassociated with this evaluation engine
- The associated thread is suspended in the middle ofan evaluation that has not completed. It is not possibleto perform nested evaluations
|
| getCompiledExpression | | public ICompiledExpression getCompiledExpression(String expression, IJavaStackFrame frame) throws DebugException(Code) | | Synchronously generates a compiled expression from the given expression
in the context of the specified stack frame. The generated expression
can be stored and evaluated later in a valid runtime context.
Compilation errors are reported in the returned compiled expression.
Parameters:
expression - expression to compile
Parameters:
frame - the context in which to compile the expression
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
- The associated thread is not currently suspended
- The stack frame is not contained in the debug targetassociated with this evaluation engine
|
| getCompiledExpression | | public ICompiledExpression getCompiledExpression(String expression, IJavaObject object) throws DebugException(Code) | | Synchronously generates a compiled expression from the given expression
in the context of the specified object. The generated expression
can be stored and evaluated later in a valid runtime context.
Compilation errors are reported in the returned compiled expression.
Parameters:
expression - expression to compile
Parameters:
object - the context in which to compile the expression
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
- The associated thread is not currently suspended
- The stack frame is not contained in the debug targetassociated with this evaluation engine
|
| getCompiledExpression | | public ICompiledExpression getCompiledExpression(String expression, IJavaReferenceType type) throws DebugException(Code) | | Synchronously generates a compiled expression from the given expression
in the context of the specified type. The generated expression
can be stored and evaluated later in a valid runtime context.
Compilation errors are reported in the returned compiled expression.
Parameters:
expression - expression to compile
Parameters:
type - the context in which to compile the expression
exception:
DebugException - if this method fails. Reasons include:- Failure communicating with the VM. The DebugException'sstatus code contains the underlying exception responsible forthe failure.
- The associated thread is not currently suspended
- The stack frame is not contained in the debug targetassociated with this evaluation engine
since:
3.1 |
|
|