net.sf.jiapi.event

Class ExceptionEventProducer

java.lang.Object

net.sf.jiapi.event.EventProducer

net.sf.jiapi.event.ExceptionEventProducer

public class ExceptionEventProducer
extends EventProducer

This class registers itself to Jiapi runtime and tracks Exception related events. When such an event happens, each registered listener will notified.

Author:

Mika Riekkinen, Joni Suominen

Constructor Summary

Constructors

Constructor and Description
ExceptionEventProducer(InstrumentationDescriptor id) Constructor.
ExceptionEventProducer(InstrumentationDescriptor id, String resolution) Constructor.

Method Summary

Modifier and Type	Method and Description
void	addExceptionListener(ExceptionListener fl) Adds a ExceptionListener.
void	catchTrapped(Object sourceObject, String exceptionName) This method is called by the Jiapi runtime.
void	catchTrapped(Object sourceObject, String exceptionName, Object target) This method is called by the Jiapi runtime.
protected void	fireCatchEvent(Object sourceObject, String exceptionName, Object target) Fires an event when exception has been caught.
void	removeExceptionListener(ExceptionListener fl) Removes a ExceptionListener.

Methods inherited from class net.sf.jiapi.event.EventProducer

getResolutions, isProtected, isProtected, match, protect, release

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionEventProducer

public ExceptionEventProducer(InstrumentationDescriptor id)

Constructor. Resolution is set to '*', which indicates all the ExceptionEvents are produced.

Parameters:

id - Instrumentation decsriptor, that this ExceptionEventProducer registers itself to.

ExceptionEventProducer

public ExceptionEventProducer(InstrumentationDescriptor id,
                              String resolution)

Constructor. Only ExceptionEvents, that match with resolution, are produced. Resolution is compared against the name of the Exception during instrumentation. Name of the Exception is exactly the same, as it is given in Java source code in catch(....) statement. This means, that if one is catching java.lang.Exception, and java.lang.ClassNotFoundException is trapped, the former is used in resolution comparison.

Parameters:

id - Instrumentation decsriptor, that this ExceptionEventProducer registers itself to.

resolution - Resolution, that is used further to select which Exceptions will trigger events to be produced.

Method Detail

addExceptionListener

public void addExceptionListener(ExceptionListener fl)

Adds a ExceptionListener.

Parameters:

fl - a ExceptionListener

removeExceptionListener

public void removeExceptionListener(ExceptionListener fl)

Removes a ExceptionListener.

Parameters:

fl - a ExceptionListener

catchTrapped

public void catchTrapped(Object sourceObject,
                         String exceptionName)

This method is called by the Jiapi runtime. It should not be called by others.

Parameters:

sourceObject - source object

exceptionName - Name of the Exception

catchTrapped

public void catchTrapped(Object sourceObject,
                         String exceptionName,
                         Object target)

This method is called by the Jiapi runtime. It should not be called by others.

Parameters:

sourceObject - source object

exceptionName - Name of the Exception

target - target

fireCatchEvent

protected void fireCatchEvent(Object sourceObject,
                              String exceptionName,
                              Object target)

Fires an event when exception has been caught.

Parameters:

sourceObject - source object

exceptionName - name

target - Target object