The Spring Framework

org.springframework.aop.interceptor
Class CustomizableTraceInterceptor

java.lang.Object
  extended by org.springframework.aop.interceptor.AbstractTraceInterceptor
      extended by org.springframework.aop.interceptor.CustomizableTraceInterceptor
All Implemented Interfaces:
Serializable, Advice, Interceptor, MethodInterceptor

public class CustomizableTraceInterceptor
extends AbstractTraceInterceptor

MethodInterceptor implementation that allows for highly customizable method-level tracing, using placeholders.

Trace messages are written on method entry, and if the method invocation succeeds on method exit. If an invocation results in an exception, then an exception message is written. The contents of these trace messages is fully customizable and special placeholders are available to allow you to include runtime information in your log messages. The placeholders available are:

There are restrictions on which placeholders can be used in which messages: see the individual message properties for details on the valid placeholders.

NOTE: This class requires JDK 1.4 or later. It uses the java.util.regex package for regular expression matching, which is only available on JDK 1.4+.

Since:
1.2
Author:
Rob Harrop
See Also:
setEnterMessage(java.lang.String), setExitMessage(java.lang.String), setExceptionMessage(java.lang.String), SimpleTraceInterceptor, Serialized Form

Field Summary
static String PLACEHOLDER_ARGUMENT_TYPES
          The $[argumentTypes] placeholder.
static String PLACEHOLDER_ARGUMENTS
          The $[arguments] placeholder.
static String PLACEHOLDER_EXCEPTION
          The $[exception] placeholder.
static String PLACEHOLDER_INVOCATION_TIME
          The $[invocationTime] placeholder.
static String PLACEHOLDER_METHOD_NAME
          The $[methodName] placeholder.
static String PLACEHOLDER_RETURN_VALUE
          The $[returnValue] placeholder.
static String PLACEHOLDER_TARGET_CLASS_NAME
          The $[targetClassName] placeholder.
static String PLACEHOLDER_TARGET_CLASS_SHORT_NAME
          The $[targetClassShortName] placeholder.
 
Fields inherited from class org.springframework.aop.interceptor.AbstractTraceInterceptor
defaultLogger
 
Constructor Summary
CustomizableTraceInterceptor()
           
 
Method Summary
protected  Object invokeUnderTrace(MethodInvocation invocation, Log logger)
          Writes a log message before the invocation based on the value of enterMessage.
protected  String replacePlaceholders(String message, MethodInvocation methodInvocation, Object returnValue, Throwable throwable, long invocationTime)
          Replace the placeholders in the given message with the supplied values, or values derived from those supplied.
 void setEnterMessage(String enterMessage)
          Ses the template used for method entry log messages.
 void setExceptionMessage(String exceptionMessage)
          Set the template used for method exception log messages.
 void setExitMessage(String exitMessage)
          Set the template used for method exit log messages.
protected  void writeToLog(Log logger, String message)
          Writes the supplied message to the supplied Log instance.
protected  void writeToLog(Log logger, String message, Throwable ex)
          Writes the supplied message and Throwable to the supplied Log instance.
 
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
 

Field Detail

PLACEHOLDER_METHOD_NAME

public static final String PLACEHOLDER_METHOD_NAME
The $[methodName] placeholder. Replaced with the name of the method being invoked.

See Also:
Constant Field Values

PLACEHOLDER_TARGET_CLASS_NAME

public static final String PLACEHOLDER_TARGET_CLASS_NAME
The $[targetClassName] placeholder. Replaced with the fully-qualifed name of the Class of the method invocation target.

See Also:
Constant Field Values

PLACEHOLDER_TARGET_CLASS_SHORT_NAME

public static final String PLACEHOLDER_TARGET_CLASS_SHORT_NAME
The $[targetClassShortName] placeholder. Replaced with the short name of the Class of the method invocation target.

See Also:
Constant Field Values

PLACEHOLDER_RETURN_VALUE

public static final String PLACEHOLDER_RETURN_VALUE
The $[returnValue] placeholder. Replaced with the String representation of the value returned by the method invocation.

See Also:
Constant Field Values

PLACEHOLDER_ARGUMENT_TYPES

public static final String PLACEHOLDER_ARGUMENT_TYPES
The $[argumentTypes] placeholder. Replaced with a comma-separated list of the argument types for the method invocation. Argument types are written as short class names.

See Also:
Constant Field Values

PLACEHOLDER_ARGUMENTS

public static final String PLACEHOLDER_ARGUMENTS
The $[arguments] placeholder. Replaced with a comma separated list of the argument values for the method invocation. Relies on the toString() method of each argument type.

See Also:
Constant Field Values

PLACEHOLDER_EXCEPTION

public static final String PLACEHOLDER_EXCEPTION
The $[exception] placeholder. Replaced with the String representation of any Throwable raised during method invocation.

See Also:
Constant Field Values

PLACEHOLDER_INVOCATION_TIME

public static final String PLACEHOLDER_INVOCATION_TIME
The $[invocationTime] placeholder. Replaced with the time taken by the invocation (in milliseconds).

See Also:
Constant Field Values
Constructor Detail

CustomizableTraceInterceptor

public CustomizableTraceInterceptor()
Method Detail

setEnterMessage

public void setEnterMessage(String enterMessage)
                     throws IllegalArgumentException
Ses the template used for method entry log messages. This template can contain any of the following placeholders:

Throws:
IllegalArgumentException - if the message template is empty or contains any invalid placeholders

setExitMessage

public void setExitMessage(String exitMessage)
Set the template used for method exit log messages. This template can contain any of the following placeholders:

Throws:
IllegalArgumentException - if the message template is empty or contains any invalid placeholders

setExceptionMessage

public void setExceptionMessage(String exceptionMessage)
Set the template used for method exception log messages. This template can contain any of the following placeholders:

Throws:
IllegalArgumentException - if the message template is empty or contains any invalid placeholders

invokeUnderTrace

protected Object invokeUnderTrace(MethodInvocation invocation,
                                  Log logger)
                           throws Throwable
Writes a log message before the invocation based on the value of enterMessage. If the invocation succeeds, then a log message is written on exit based on the value exitMessage. If an exception occurs during invocation, then a message is written based on the value of exceptionMessage.

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:
setEnterMessage(java.lang.String), setExitMessage(java.lang.String), setExceptionMessage(java.lang.String)

writeToLog

protected void writeToLog(Log logger,
                          String message)
Writes the supplied message to the supplied Log instance.

See Also:
writeToLog(org.apache.commons.logging.Log, String, Throwable)

writeToLog

protected void writeToLog(Log logger,
                          String message,
                          Throwable ex)
Writes the supplied message and Throwable to the supplied Log instance. By default messages are written at TRACE level. Sub-classes can override this method to control which level the message is written at.


replacePlaceholders

protected String replacePlaceholders(String message,
                                     MethodInvocation methodInvocation,
                                     Object returnValue,
                                     Throwable throwable,
                                     long invocationTime)
Replace the placeholders in the given message with the supplied values, or values derived from those supplied.

Parameters:
message - the message template containing the placeholders to be replaced
methodInvocation - the MethodInvocation being logged. Used to derive values for all placeholders except $[exception] and $[returnValue].
returnValue - any value returned by the invocation. Used to replace the $[returnValue] placeholder. May be null.
throwable - any Throwable raised during the invocation. The value of Throwable.toString() is replaced for the $[exception] placeholder. May be null.
invocationTime - the value to write in place of the $[invocationTime] placeholder
Returns:
the formatted output to write to the log

The Spring Framework

Copyright © 2002-2007 The Spring Framework.