net.sf.jiapi.interceptor

Class FieldInterceptor2

java.lang.Object

net.sf.jiapi.event.EventProducer

net.sf.jiapi.interceptor.FieldInterceptor2

public class FieldInterceptor2
extends EventProducer

FieldInterceptor2 intercepts public field accesses and delegates task to FieldHandler.

Following code snippet is an example, how to initialize FieldInterceptor2:

 InstrumentationContext ctx = new InstrumentationContext();
 InstrumentationDescriptor id = new InstrumentationDescriptor();
 id.addInclusionRule("samples.*");
 ctx.addInstrumentationDescriptor(id);
 
 FieldInterceptor2 fi = new FieldInterceptor2(id, "samples*", this);
 

FieldInterceptor2 intercepts only accessess to public fields.

NOTE: THIS CLASS IS OBSOLETE. USE FieldInterceptor INSTEAD

Author:

Mika Riekkinen

Constructor Summary

Constructors

Constructor and Description
FieldInterceptor2(InstrumentationDescriptor id, FieldHandler handler) Constructor.
FieldInterceptor2(InstrumentationDescriptor id, String[] resolutions, FieldHandler handler) Creates new FieldInterceptor2.
FieldInterceptor2(InstrumentationDescriptor id, String resolution, FieldHandler handler) Creates new FieldInterceptor2.

Method Summary

Modifier and Type	Method and Description
Object	getField(Object o, String name) Called by Jiapi runtime.
void	setField(Object o, String name, Object value) Called by Jiapi runtime.

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

FieldInterceptor2

public FieldInterceptor2(InstrumentationDescriptor id,
                         FieldHandler handler)

Constructor. Resolution is set to '*'.

Parameters:

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

handler - FieldHandler

FieldInterceptor2

public FieldInterceptor2(InstrumentationDescriptor id,
                         String resolution,
                         FieldHandler handler)

Creates new FieldInterceptor2. Resolution tells, which fields trigger interception.

Parameters:

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

resolution - Resolution, that is used to select which fields trigger interception

handler - FieldHandler

FieldInterceptor2

public FieldInterceptor2(InstrumentationDescriptor id,
                         String[] resolutions,
                         FieldHandler handler)

Creates new FieldInterceptor2.

Parameters:

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

resolutions - Resolutions, that is used to select which fields trigger interception

handler - FieldHandler

Method Detail

setField

public void setField(Object o,
                     String name,
                     Object value)
              throws Throwable

Called by Jiapi runtime.

Parameters:

o - if target field is static, this parameter holds a Class of the target field, otherwise this is the instance, that fieldset should be acted on.

name - Fully qualified name of the field

value - Value to set

Throws:

Throwable - on error

getField

public Object getField(Object o,
                       String name)
                throws Throwable

Called by Jiapi runtime.

Parameters:

o - if target field is static, this parameter holds a Class of the target field, otherwise this is the instance, that fieldset should be acted on.

name - Fully qualified name of the field

Returns:

Object

Throws:

Throwable - on error