org.apache.xalan.trace

Class TraceManager


public class TraceManager
extends java.lang.Object

This class manages trace listeners, and acts as an interface for the tracing functionality in Xalan.

Constructor Summary

TraceManager(TransformerImpl transformer)
Constructor for the trace manager.

Method Summary

void
addTraceListener(TraceListener tl)
Add a trace listener for the purposes of debugging and diagnosis.
void
fireExtensionEndEvent(Method method, Object instance, Object[] arguments)
Fire an end extension event.
void
fireExtensionEndEvent(ExtensionEvent ee)
Fire an end extension event.
void
fireExtensionEvent(Method method, Object instance, Object[] arguments)
Fire an end extension event.
void
fireExtensionEvent(ExtensionEvent ee)
Fire an end extension event.
void
fireGenerateEvent(GenerateEvent te)
Fire a generate event.
void
fireSelectedEndEvent(int sourceNode, ElemTemplateElement styleNode, String attributeName, XPath xpath, XObject selection)
Fire a selection event.
void
fireSelectedEndEvent(EndSelectionEvent se)
Fire a selection event.
void
fireSelectedEvent(int sourceNode, ElemTemplateElement styleNode, String attributeName, XPath xpath, XObject selection)
Fire a selection event.
void
fireSelectedEvent(SelectionEvent se)
Fire a selection event.
void
fireTraceEndEvent(ElemTemplateElement styleNode)
Fire a end trace event, after all children of an element have been executed.
void
fireTraceEndEvent(TracerEvent te)
Fire a trace event.
void
fireTraceEvent(ElemTemplateElement styleNode)
Fire a trace event.
void
fireTraceEvent(TracerEvent te)
Fire a trace event.
boolean
hasTraceListeners()
Tell if trace listeners are present.
void
removeTraceListener(TraceListener tl)
Remove a trace listener.

Constructor Details

TraceManager

public TraceManager(TransformerImpl transformer)
Constructor for the trace manager.
Parameters:
transformer - a non-null instance of a transformer

Method Details

addTraceListener

public void addTraceListener(TraceListener tl)
            throws TooManyListenersException
Add a trace listener for the purposes of debugging and diagnosis.
Parameters:
tl - Trace listener to be added.

fireExtensionEndEvent

public void fireExtensionEndEvent(Method method,
                                  Object instance,
                                  Object[] arguments)
Fire an end extension event.
Parameters:
method - The java method about to be executed
instance - The instance the method will be executed on
arguments - Parameters passed to the method.
See Also:
java.lang.reflect.Method.invoke

fireExtensionEndEvent

public void fireExtensionEndEvent(ExtensionEvent ee)
Fire an end extension event.
Parameters:
ee - the ExtensionEvent to fire
See Also:
java.lang.reflect.Method.invoke

fireExtensionEvent

public void fireExtensionEvent(Method method,
                               Object instance,
                               Object[] arguments)
Fire an end extension event.
Parameters:
method - The java method about to be executed
instance - The instance the method will be executed on
arguments - Parameters passed to the method.
See Also:
java.lang.reflect.Method.invoke

fireExtensionEvent

public void fireExtensionEvent(ExtensionEvent ee)
Fire an end extension event.
Parameters:
ee - the ExtensionEvent to fire
See Also:
java.lang.reflect.Method.invoke

fireGenerateEvent

public void fireGenerateEvent(GenerateEvent te)
Fire a generate event.
Parameters:
te - Generate Event to fire

fireSelectedEndEvent

public void fireSelectedEndEvent(int sourceNode,
                                 ElemTemplateElement styleNode,
                                 String attributeName,
                                 XPath xpath,
                                 XObject selection)
            throws javax.xml.transform.TransformerException
Fire a selection event.
Parameters:
sourceNode - Current source node
styleNode - node in the style tree reference for the event.
attributeName - The attribute name from which the selection is made.
xpath - The XPath that executed the selection.
selection - The result of the selection.

fireSelectedEndEvent

public void fireSelectedEndEvent(EndSelectionEvent se)
            throws javax.xml.transform.TransformerException
Fire a selection event.
Parameters:
se - Selection event to fire

fireSelectedEvent

public void fireSelectedEvent(int sourceNode,
                              ElemTemplateElement styleNode,
                              String attributeName,
                              XPath xpath,
                              XObject selection)
            throws javax.xml.transform.TransformerException
Fire a selection event.
Parameters:
sourceNode - Current source node
styleNode - node in the style tree reference for the event.
attributeName - The attribute name from which the selection is made.
xpath - The XPath that executed the selection.
selection - The result of the selection.

fireSelectedEvent

public void fireSelectedEvent(SelectionEvent se)
            throws javax.xml.transform.TransformerException
Fire a selection event.
Parameters:
se - Selection event to fire

fireTraceEndEvent

public void fireTraceEndEvent(ElemTemplateElement styleNode)
Fire a end trace event, after all children of an element have been executed.
Parameters:
styleNode - Stylesheet template node

fireTraceEndEvent

public void fireTraceEndEvent(TracerEvent te)
Fire a trace event.
Parameters:
te - Trace event to fire

fireTraceEvent

public void fireTraceEvent(ElemTemplateElement styleNode)
Fire a trace event.
Parameters:
styleNode - Stylesheet template node

fireTraceEvent

public void fireTraceEvent(TracerEvent te)
Fire a trace event.
Parameters:
te - Trace event to fire

hasTraceListeners

public boolean hasTraceListeners()
Tell if trace listeners are present.
Returns:
True if there are trace listeners

removeTraceListener

public void removeTraceListener(TraceListener tl)
Remove a trace listener.
Parameters:
tl - Trace listener to be removed.

Copyright © 2006 Apache XML Project. All Rights Reserved.