com.jamonapi.aop.spring

Class JamonAspect

java.lang.Object

com.jamonapi.aop.spring.JamonAspect

public class JamonAspect
extends Object

This class tracks the performance of classes and methods:
JAMon Label=void com.stevesouza.spring.MonitorMe3.anotherMethod2(), Units=ms.: (LastValue=0.0, Hits=10.0, Avg=0.3, Total=3.0, Min=0.0, Max=1.0, Active=0.0, Avg Active=1.0, Max Active=1.0, First Access=Tue Jun 03 21:11:21 CEST 2014, Last Access=Tue Jun 03 21:11:26 CEST 2014)

And Exceptions if the method throws one. Exceptions are tracked under a general name for all exceptions 'com.jamonapi.Exceptions', as well as the specific exception name (i.e. java.io.IOException, ...). An example follows:
JAMon Label=java.io.IOException, Units=Exception: (LastValue=1.0, Hits=10.0, Avg=1.0, Total=10.0, Min=1.0, Max=1.0, Active=0.0, Avg Active=0.0, Max Active=0.0, First Access=Tue Jun 03 21:11:21 CEST 2014, Last Access=Tue Jun 03 21:11:26 CEST 2014)
JAMon Label=com.jamonapi.Exceptions, Units=Exception: (LastValue=1.0, Hits=10.0, Avg=1.0, Total=10.0, Min=1.0, Max=1.0, Active=0.0, Avg Active=0.0, Max Active=0.0, First Access=Tue Jun 03 21:11:21 CEST 2014, Last Access=Tue Jun 03 21:11:26 CEST 2014)

The detailed stacktrace is kept if an exception is thrown. This can be viewed in the jamon war, if setExceptionBufferListener is enabled which it is by default.

There are also method argument values which can be saved in the jamon details for both the method invocation jamon details and the stack trace jamon details.

Spring can automatically find this aspect - or alternatively it could be created explicitly in applicationContext.xml. See applicationContext.xml in the test code for some sample usage. By default each aspect is a singleton within the applicationContext

Field Summary

Fields

Modifier and Type	Field and Description
protected JamonAopKeyHelperInt	keyHelper

Constructor Summary

Constructors

Constructor and Description
JamonAspect()
JamonAspect(JamonAopKeyHelperInt keyHelper)

Method Summary

Modifier and Type	Method and Description
Object	monitor(org.aspectj.lang.ProceedingJoinPoint proceedingJoinPoint) Wrap jamon calls around the invoked method.
void	setExceptionBufferListener(boolean enable) If true is passed in then a buffer will contain the most recent stack traces.
void	setKeyHelper(JamonAopKeyHelperInt keyHelper)
void	setUseArgsWithExceptionDetails(boolean useArgsWithExceptionDetails) Specifies to have the methods arguments viewable in the jamon monitor details.
void	setUseArgsWithMethodDetails(boolean useArgsWithMethodDetails) Specifies to have the methods arguments viewable in the jamon monitor details.

Methods inherited from class java.lang.Object

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

Field Detail

keyHelper

protected JamonAopKeyHelperInt keyHelper

Constructor Detail

JamonAspect

public JamonAspect()

JamonAspect

public JamonAspect(JamonAopKeyHelperInt keyHelper)

Method Detail

monitor

public Object monitor(org.aspectj.lang.ProceedingJoinPoint proceedingJoinPoint)
               throws Throwable

Wrap jamon calls around the invoked method. Also track exceptions if they are thrown

Throws:

Throwable

setKeyHelper

public void setKeyHelper(JamonAopKeyHelperInt keyHelper)

setExceptionBufferListener

public void setExceptionBufferListener(boolean enable)

If true is passed in then a buffer will contain the most recent stack traces. This is viewable via the jamon web app or programmatically. This is very handy for debugging. By default this is enabled (true)

Parameters:

enable -

setUseArgsWithMethodDetails

public void setUseArgsWithMethodDetails(boolean useArgsWithMethodDetails)

Specifies to have the methods arguments viewable in the jamon monitor details. This is viewable from the jamon web application. It will allow you to see what values were passed to monitored methods via the web app. By default this is disabled.

Parameters:

useArgsWithMethodDetails -

setUseArgsWithExceptionDetails

public void setUseArgsWithExceptionDetails(boolean useArgsWithExceptionDetails)

Specifies to have the methods arguments viewable in the jamon monitor details. This is viewable from the jamon web application. It will allow you to see what values were passed to monitored methods that threw an exception. By default this is disabled.

Parameters:

useArgsWithExceptionDetails -