net.sf.jiapi.event

Class FieldEventProducer

java.lang.Object

net.sf.jiapi.event.EventProducer

net.sf.jiapi.event.FieldEventProducer

public class FieldEventProducer
extends EventProducer

This class registers itself to Jiapi runtime and tracks field accesses. That is, gets and sets. When either event happens it will notify each listeners that has been registered.

Author:

Mika Riekkinen, Joni Suominen

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
void	addFieldListener(FieldListener fl) Adds a FieldListener.
void	fieldGet(Object sourceObject, String fieldName) This method is called by the Jiapi runtime.
void	fieldSet(Object sourceObject, String fieldName) This method is called by the Jiapi runtime.
protected void	fireFieldGetEvent(Object sourceObject, String fieldName) Fires an event when a field has been accessed(get).
protected void	fireFieldSetEvent(Object sourceObject, String fieldName) Fires an event when a field has been accessed(set).
void	removeFieldListener(FieldListener fl) Removes a FieldListener.

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

FieldEventProducer

public FieldEventProducer(InstrumentationDescriptor id)

Constructor. Resolution is set to '*', which indicates all field accesses are trapped.

Parameters:

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

FieldEventProducer

public FieldEventProducer(InstrumentationDescriptor id,
                          String resolution)

Constructor. Given resolution is compared to name of the field, and if it matches, a FieldEvent is produced.

Parameters:

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

resolution - Resolution that is used in deciding whether or not an event should be produced.

Method Detail

addFieldListener

public void addFieldListener(FieldListener fl)

Adds a FieldListener.

Parameters:

fl - a FieldListener

removeFieldListener

public void removeFieldListener(FieldListener fl)

Removes a FieldListener.

Parameters:

fl - a FieldListener

fieldGet

public void fieldGet(Object sourceObject,
                     String fieldName)

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

Parameters:

sourceObject - source Object

fieldName - Name of the field

fieldSet

public void fieldSet(Object sourceObject,
                     String fieldName)

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

Parameters:

sourceObject - source Object

fieldName - Name of the field

fireFieldSetEvent

protected void fireFieldSetEvent(Object sourceObject,
                                 String fieldName)

Fires an event when a field has been accessed(set).

Parameters:

sourceObject - source Object

fieldName - Name of the field

fireFieldGetEvent

protected void fireFieldGetEvent(Object sourceObject,
                                 String fieldName)

Fires an event when a field has been accessed(get).

Parameters:

sourceObject - Source Object

fieldName - Name of the field