Package net.ssehub.easy.instantiation.core.model.expressions

Interface ITracer

All Known Subinterfaces:

ITracer, ITracer, ITracer

All Known Implementing Classes:

AbstractTracerBase, AbstractVilTracer, NoTracer, NoTracer, NoTracer, NoTracer, StreamTracer, StreamTracer, StreamTracer, StreamTracer, StreamVilTracer, VilTracer

public interface ITracer

Defines a tracer interface for receiving information about runtime execution, e.g., for testing.

Author:

Holger Eichelberger

Method Summary

Modifier and Type	Method	Description
void	failedAt(Expression expression)	Is called when the evaluation of an expression caused an execution failure.
java.util.Locale	getLocale()	Returns the current locale for evaluation.
RuntimeEnvironment<?,?>	getRuntimeEnvironment()	Returns the actual runtime environment.
void	setLocale(java.util.Locale locale)	Changes the current locale.
void	setRuntimeEnvironment(RuntimeEnvironment<?,?> environment)	Defines the actual runtime environment.
void	visitedCallExpression(OperationDescriptor descriptor, CallExpression.CallType callType, java.lang.Object[] args, java.lang.Object result)	Is called after a resolved call expression is actually executed.
void	visitingCallExpression(OperationDescriptor descriptor, CallExpression.CallType callType, java.lang.Object[] args)	Is called before a resolved call expression is actually executed.

Method Detail

visitingCallExpression

void visitingCallExpression(OperationDescriptor descriptor,
                            CallExpression.CallType callType,
                            java.lang.Object[] args)

Is called before a resolved call expression is actually executed. Do not modify the parameters!

Parameters:

descriptor - the descriptor to be called

callType - the type of the call

args - the actual arguments

visitedCallExpression

void visitedCallExpression(OperationDescriptor descriptor,
                           CallExpression.CallType callType,
                           java.lang.Object[] args,
                           java.lang.Object result)

Is called after a resolved call expression is actually executed. Do not modify the parameters!

Parameters:

descriptor - the descriptor to be called

callType - the type of the call

args - the actual arguments

result - the result of the call

failedAt

void failedAt(Expression expression)

Is called when the evaluation of an expression caused an execution failure.

Parameters:

expression - the failing expression

getLocale

java.util.Locale getLocale()

Returns the current locale for evaluation.

Returns:

the current locale

setLocale

void setLocale(java.util.Locale locale)

Changes the current locale.

Parameters:

locale - the new locale (ignored if null)

setRuntimeEnvironment

void setRuntimeEnvironment(RuntimeEnvironment<?,?> environment)

Defines the actual runtime environment.

Parameters:

environment - the environment

getRuntimeEnvironment

RuntimeEnvironment<?,?> getRuntimeEnvironment()

Returns the actual runtime environment.

Returns:

registry the runtime environment (may be null if not currently executing)