org.cojen.dirmi.trace

Class NullHandler

java.lang.Object

org.cojen.dirmi.trace.NullHandler

All Implemented Interfaces:

TraceHandler

public class NullHandler
extends Object
implements TraceHandler

TraceHandler which effectively disables tracing.

Author:

Brian S O'Neill

Constructor Summary

Constructors

Constructor and Description
NullHandler(TraceToolbox toolbox)

Method Summary

Modifier and Type	Method and Description
void	enterMethod(int mid) Called by a traced method upon entry.
void	enterMethod(int mid, Object... arguments) Called by a traced method upon entry.
void	enterMethod(int mid, Object argument) Called by a traced method upon entry.
void	exitMethod(int mid) Called by a traced method upon exit.
void	exitMethod(int mid, long timeNanos) Called by a traced method upon exit.
void	exitMethod(int mid, Object result) Called by a traced method upon exit.
void	exitMethod(int mid, Object result, long timeNanos) Called by a traced method upon exit.
void	exitMethod(int mid, Throwable t) Called by a traced method upon exit caused by a thrown exception.
void	exitMethod(int mid, Throwable t, long timeNanos) Called by a traced method upon exit caused by a thrown exception.
TraceModes	getTraceModes(String className) Return allowed tracing modes for the given class.

Methods inherited from class java.lang.Object

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

Constructor Detail

NullHandler

public NullHandler(TraceToolbox toolbox)

Method Detail

getTraceModes

public TraceModes getTraceModes(String className)

Description copied from interface: TraceHandler

Return allowed tracing modes for the given class.

Specified by:

getTraceModes in interface TraceHandler

Parameters:

className - full name of class which may contain traced methods

Returns:

modes or null if none allowed

enterMethod

public void enterMethod(int mid)

Description copied from interface: TraceHandler

Called by a traced method upon entry.

Specified by:

enterMethod in interface TraceHandler

Parameters:

mid - method id

enterMethod

public void enterMethod(int mid,
                        Object argument)

Description copied from interface: TraceHandler

Called by a traced method upon entry. This method is never called if the trace was not configured to pass arguments or if the traced method has no arguments.

Specified by:

enterMethod in interface TraceHandler

Parameters:

mid - method id

argument - argument passed to method; is "this" for non-static method

enterMethod

public void enterMethod(int mid,
                        Object... arguments)

Description copied from interface: TraceHandler

Called by a traced method upon entry. This method is never called if the trace was not configured to pass arguments or if the traced method has no arguments.

Specified by:

enterMethod in interface TraceHandler

Parameters:

mid - method id

arguments - arguments passed to method; first is "this" for non-static method

exitMethod

public void exitMethod(int mid)

Description copied from interface: TraceHandler

Called by a traced method upon exit.

Specified by:

exitMethod in interface TraceHandler

Parameters:

mid - method id

exitMethod

public void exitMethod(int mid,
                       long timeNanos)

Description copied from interface: TraceHandler

Called by a traced method upon exit. This method is never called if the trace was not configured to measure execution time.

Specified by:

exitMethod in interface TraceHandler

Parameters:

mid - method id

timeNanos - total execution time of method, in nanoseconds

exitMethod

public void exitMethod(int mid,
                       Object result)

Description copied from interface: TraceHandler

Called by a traced method upon exit. This method is never called if the trace was not configured to pass return values or if the traced method returns void.

Specified by:

exitMethod in interface TraceHandler

Parameters:

mid - method id

result - method return value

exitMethod

public void exitMethod(int mid,
                       Object result,
                       long timeNanos)

Description copied from interface: TraceHandler

Called by a traced method upon exit. This method is never called if the trace was not configured to pass return values and measure execution time.

Specified by:

exitMethod in interface TraceHandler

Parameters:

mid - method id

result - method return value

timeNanos - total execution time of method, in nanoseconds

exitMethod

public void exitMethod(int mid,
                       Throwable t)

Description copied from interface: TraceHandler

Called by a traced method upon exit caused by a thrown exception. This method is never called if the trace was not configured to pass thrown exceptions.

Specified by:

exitMethod in interface TraceHandler

Parameters:

mid - method id

t - exception thrown by method

exitMethod

public void exitMethod(int mid,
                       Throwable t,
                       long timeNanos)

Description copied from interface: TraceHandler

Called by a traced method upon exit caused by a thrown exception. This method is never called if the trace was not configured to pass thrown exceptions and measure execution time.

Specified by:

exitMethod in interface TraceHandler

Parameters:

mid - method id

t - exception thrown by method

timeNanos - total execution time of method, in nanoseconds