This package provides an interface to Saxon tracing and debugging capabilities.
The package was originally created by Edwin Glaser.
The package includes three tracing modules that can be optionally selected:
TimedTraceListener. These all receive notification of the same events,
but select and format the events in different ways to meet different requirements.
Other events are notified through the
TraceListener interface that
are ignored by tracing applications, but may be of interest to debuggers.
Interface Summary Interface Description ExpressionPresenter.Options InstructionInfoInformation about an instruction in the stylesheet or a construct in a Query, made available at run-time to a TraceListener. TraceableA construct whose execution can be notified to a TraceListener. TraceableComponentA construct whose execution can be notified to a TraceListener.
Class Summary Class Description AbstractTraceListenerThis is the standard trace listener used when the -T option is specified on the command line. ContextStackFrameAn entry on the context stack. ContextStackFrame.ApplyTemplatesSubclass of ContextStackFrame representing an xsl:apply-templates call in XSLT ContextStackFrame.BuiltInTemplateRuleSubclass of ContextStackFrame representing a built-in template rule in XSLT ContextStackFrame.CallingApplicationSubclass of ContextStackFrame representing the outermost stack frame, for the calling application ContextStackFrame.CallTemplateSubclass of ContextStackFrame representing an xsl:call-template instruction in XSLT ContextStackFrame.FunctionCallSubclass of ContextStackFrame representing a call to a user-defined function either in XSLT or XQuery ContextStackFrame.VariableEvaluationSubclass of ContextStackFrame representing the evaluation of a variable (typically a global variable) ContextStackIteratorThis class provides a representation of the current runtime call stack, as represented by the stack of XPathContext objects. CountingFilterA filter that can be inserted into a Receiver pipeline to count the events that pass through. ExpressionPresenterThis class handles the display of an abstract expression tree in an XML format with some slight resemblance to XQueryX ExpressionPresenter.ExportOptions InstrumentationInternal class used for instrumentation purposes. ModeTraceListenerA trace listener for XSLT that only handles invocation of template rules; enabled using saxon:trace="yes" on the xsl:mode declaration TimingCodeInjectorA code injector that wraps the body of a template or function in a TraceExpression, which causes the TimingTraceListener to be notified at the start and end of the function/template evaluation TimingTraceListenerA trace listener that records timing information for templates and functions, outputting this information as an HTML report to a specified destination when the transformation completes. TraceCodeInjectorA code injector that wraps every expression (other than a literal) in a TraceExpression, which causes a TraceListener to be notified when the expression is evaluated TraceEventMulticasterA class which implements efficient and thread-safe multi-cast event dispatching for the TraceListener evants. TracingFilterA filter that can be inserted into a Receiver pipeline to trace the events that pass through. XQueryTraceCodeInjectorA code injector designed to support the -T tracing option in XQuery XQueryTraceListenerA Simple trace listener for XQuery that writes messages (by default) to System.err XSLTTraceCodeInjectorA code injector that wraps every expression (other than a literal) in a TraceExpression, which causes a TraceListener to be notified when the expression is evaluated XSLTTraceListenerA Simple trace listener for XSLT that writes messages (by default) to System.err