Package ortus.boxlang.runtime.bifs.global.system

Class Trace

java.lang.Object

ortus.boxlang.runtime.bifs.BIF

ortus.boxlang.runtime.bifs.global.system.Trace

@BoxBIF
public class Trace
extends BIF

Field Summary

Fields inherited from class ortus.boxlang.runtime.bifs.BIF

__functionName, __isMemberExecution, asyncService, cacheService, componentService, declaredArguments, functionService, interceptorService, logger, moduleService, runtime, schedulerService

Constructor Summary

Constructors

Constructor	Description
Trace()	Constructor

Method Summary

Modifier and Type	Method	Description
Object	_invoke(IBoxContext context, ArgumentsScope arguments)	Traces messages into the tracing facilites so they can be display by the running runtime either in console, or debug output or whatever the runtime is configured to do.

Methods inherited from class ortus.boxlang.runtime.bifs.BIF

announce, getDeclaredArguments, invoke

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Trace

public Trace()

Constructor

Method Details

_invoke

public Object _invoke(IBoxContext context,
 ArgumentsScope arguments)

Traces messages into the tracing facilites so they can be display by the running runtime either in console, or debug output or whatever the runtime is configured to do.

It will track from where the trace call was made and the message will be logged with the category, type and text provided.

All tracers will be sent to the trace.log file in the logs directory of the runtime as well.

If the abort attribute is set to true, the current request will be aborted after the trace call.

Tracers will only be displayed if the runtime is in debug mode.. However, all traces will be logged regardless of the debug mode flag.

The extraInfo attribute is optional and can be any simple or complex object. We will convert it to string for logging using the toString() method on the object. You can also use the alias of var for this attribute as well.

Specified by:

_invoke in class BIF

Parameters:

context - The context in which the Component is being invoked

arguments - The BIF Arguments

Returns:

The result of the invocation