org.springframework.aop.interceptor
Class SimpleTraceInterceptor

java.lang.Object
  extended by org.springframework.aop.interceptor.AbstractTraceInterceptor
      extended by org.springframework.aop.interceptor.SimpleTraceInterceptor
All Implemented Interfaces:
Serializable, Advice, Interceptor, MethodInterceptor
Direct Known Subclasses:
DebugInterceptor, TraceInterceptor

public class SimpleTraceInterceptor
extends AbstractTraceInterceptor

Simple AOP Alliance MethodInterceptor that can be introduced in a chain to display verbose trace information about intercepted method invocations, with method entry and method exit info.

Consider using CustomizableTraceInterceptor for more advanced needs. Note that CustomizableTraceInterceptor requires JDK 1.4 or later.

Since:
1.2
Author:
Dmitriy Kopylenko, Juergen Hoeller
See Also:
CustomizableTraceInterceptor, Serialized Form

Field Summary
 
Fields inherited from class org.springframework.aop.interceptor.AbstractTraceInterceptor
defaultLogger
 
Constructor Summary
SimpleTraceInterceptor()
          Create a new SimpleTraceInterceptor with a static logger.
SimpleTraceInterceptor(boolean useDynamicLogger)
          Create a new SimpleTraceInterceptor with dynamic or static logger, according to the given flag.
 
Method Summary
protected  String getInvocationDescription(MethodInvocation invocation)
          Return a description for the given method invocation.
protected  Object invokeUnderTrace(MethodInvocation invocation, org.apache.commons.logging.Log logger)
          Subclasses must override this method to perform any tracing around the supplied MethodInvocation.
 
Methods inherited from class org.springframework.aop.interceptor.AbstractTraceInterceptor
getLoggerForInvocation, invoke, isInterceptorEnabled, isLogEnabled, setHideProxyClassNames, setLoggerName, setUseDynamicLogger
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SimpleTraceInterceptor

public SimpleTraceInterceptor()
Create a new SimpleTraceInterceptor with a static logger.


SimpleTraceInterceptor

public SimpleTraceInterceptor(boolean useDynamicLogger)
Create a new SimpleTraceInterceptor with dynamic or static logger, according to the given flag.

Parameters:
useDynamicLogger - whether to use a dynamic logger or a static logger
See Also:
AbstractTraceInterceptor.setUseDynamicLogger(boolean)
Method Detail

invokeUnderTrace

protected Object invokeUnderTrace(MethodInvocation invocation,
                                  org.apache.commons.logging.Log logger)
                           throws Throwable
Description copied from class: AbstractTraceInterceptor
Subclasses must override this method to perform any tracing around the supplied MethodInvocation. Subclasses are responsible for ensuring that the MethodInvocation actually executes by calling MethodInvocation.proceed().

By default, the passed-in Log instance will have log level "trace" enabled. Subclasses do not have to check for this again, unless they overwrite the isInterceptorEnabled method to modify the default behavior.

Specified by:
invokeUnderTrace in class AbstractTraceInterceptor
logger - the Log to write trace messages to
Returns:
the result of the call to MethodInvocation.proceed()
Throws:
Throwable - if the call to MethodInvocation.proceed() encountered any errors
See Also:
AbstractTraceInterceptor.isInterceptorEnabled(org.aopalliance.intercept.MethodInvocation, org.apache.commons.logging.Log), AbstractTraceInterceptor.isLogEnabled(org.apache.commons.logging.Log)

getInvocationDescription

protected String getInvocationDescription(MethodInvocation invocation)
Return a description for the given method invocation.

Parameters:
invocation - the invocation to describe
Returns:
the description


Copyright (c) 2002-2006 The Spring Framework Project.