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

Interface ITracer

All Superinterfaces:

ITracer

All Known Subinterfaces:

ITracer, ITracer

All Known Implementing Classes:

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

public interface ITracer
extends ITracer

A simple tracer interface providing test support to the execution part.

Author:

Holger Eichelberger

Method Summary

Modifier and Type	Method	Description
void	enable(boolean enable)	Enables or disables the tracer.
ITraceFilter	getTraceFilter()	Returns the active trace filter.
void	setTraceFilter(ITraceFilter filter)	Sets a trace filter on this tracer.
void	trace(java.lang.String text)	Emits a trace string.
void	traceError(java.lang.String text)	Emits an error trace string.
void	traceExecutionException(VilException exception)	Traces a top-level execution exception, i.e., execution a VIL script or template failed.
void	traceWarning(java.lang.String text)	Emits a warning trace string.
void	valueDefined(VariableDeclaration var, FieldDescriptor field, java.lang.Object value)	Is called when a value of a variable is defined.

Methods inherited from interface net.ssehub.easy.instantiation.core.model.expressions.ITracer

failedAt, getLocale, getRuntimeEnvironment, setLocale, setRuntimeEnvironment, visitedCallExpression, visitingCallExpression

Method Detail

trace

void trace(java.lang.String text)

Emits a trace string.

Parameters:

text - the text to be emitted

traceWarning

void traceWarning(java.lang.String text)

Emits a warning trace string.

Parameters:

text - the text to be emitted

traceError

void traceError(java.lang.String text)

Emits an error trace string.

Parameters:

text - the text to be emitted

valueDefined

void valueDefined(VariableDeclaration var,
                  FieldDescriptor field,
                  java.lang.Object value)

Is called when a value of a variable is defined.

Parameters:

var - the modified variable

field - the field in var, may be null

value - the actual value

traceExecutionException

void traceExecutionException(VilException exception)

Traces a top-level execution exception, i.e., execution a VIL script or template failed.

Parameters:

exception - the exception

enable

void enable(boolean enable)

Enables or disables the tracer. By default, a tracer is enabled.

Parameters:

enable - enable or disable

setTraceFilter

void setTraceFilter(ITraceFilter filter)

Sets a trace filter on this tracer.

Parameters:

filter - the new trace filter, ignored if null

getTraceFilter

ITraceFilter getTraceFilter()

Returns the active trace filter.

Returns:

the filter, may be null if the tracer does not support filters