net.sourceforge.cobertura.instrument.pass2

Class BuildClassMapTouchPointListener

java.lang.Object

net.sourceforge.cobertura.instrument.pass2.BuildClassMapTouchPointListener

All Implemented Interfaces:

TouchPointListener

public class BuildClassMapTouchPointListener
extends java.lang.Object
implements TouchPointListener

Analyzes given method and applies information about all found important places into classmap.

Author:

piotr.tabor@gmail.com

Field Summary

Fields

Modifier and Type	Field and Description
private ClassMap	classmap

Constructor Summary

Constructors

Constructor and Description
BuildClassMapTouchPointListener(ClassMap classMap)

Method Summary

Modifier and Type	Method and Description
void	afterJump(int eventId, org.objectweb.asm.Label label, int currentLine, org.objectweb.asm.MethodVisitor nextMethodVisitor) Before code responsible for realizing 'interesting' JUMP JUMP event is not called in case of GOTO and RETURN instruction (not conditional JUMPS)
void	afterLabel(int eventId, org.objectweb.asm.Label label, int currentLine, org.objectweb.asm.MethodVisitor mv) Called before processing 'label' directive
void	afterLineNumber(int eventId, org.objectweb.asm.Label label, int currentLine, org.objectweb.asm.MethodVisitor nextMethodVisitor, java.lang.String methodName, java.lang.String methodSignature) after LINENUMBER instruction was processed.
void	afterMethodStart(org.objectweb.asm.MethodVisitor nextMethodVisitor) Event called when a new method have been just started for instrumentation.
void	beforeJump(int eventId, org.objectweb.asm.Label label, int currentLine, org.objectweb.asm.MethodVisitor nextMethodVisitor) Called after code responsible for realizing 'interesting' JUMP JUMP event is not called in case of GOTO and RETURN instruction (not conditional JUMPS)
void	beforeLabel(int eventId, org.objectweb.asm.Label label, int currentLine, org.objectweb.asm.MethodVisitor mv) Called before processing 'label' directive
void	beforeSwitch(int eventId, org.objectweb.asm.Label def, org.objectweb.asm.Label[] labels, int currentLine, org.objectweb.asm.MethodVisitor mv, java.lang.String conditionType) Called befere processing switch statement.
void	ignoreLine(int eventId, int currentLine) If we determined that some line should be not 'counted' by cobertura (for example the line might be specified in AbstractFindTouchPointsClassInstrumenter.ignoreRegexp) we call this method.

Methods inherited from class java.lang.Object

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

Field Detail

classmap

private final ClassMap classmap

Constructor Detail

BuildClassMapTouchPointListener

public BuildClassMapTouchPointListener(ClassMap classMap)

Method Detail

beforeJump

public void beforeJump(int eventId,
                       org.objectweb.asm.Label label,
                       int currentLine,
                       org.objectweb.asm.MethodVisitor nextMethodVisitor)

Description copied from interface: TouchPointListener

Called after code responsible for realizing 'interesting' JUMP

JUMP event is not called in case of GOTO and RETURN instruction (not conditional JUMPS)

Specified by:

beforeJump in interface TouchPointListener

Parameters:

eventId - - id of the detected event.

label - - destination label of the jump

currentLine - - number of currently visited line

nextMethodVisitor - - sink for instrumented code

beforeLabel

public void beforeLabel(int eventId,
                        org.objectweb.asm.Label label,
                        int currentLine,
                        org.objectweb.asm.MethodVisitor mv)

Description copied from interface: TouchPointListener

Called before processing 'label' directive

Specified by:

beforeLabel in interface TouchPointListener

Parameters:

eventId - - id of the detected event.

label - - internal identifier of label being found (single pass of instrumentation valid only)

currentLine - - number of line in which the 'switch' keyword has been found (number of line currently being processed)

mv - - sink for instrumented (injected) code

afterLineNumber

public void afterLineNumber(int eventId,
                            org.objectweb.asm.Label label,
                            int currentLine,
                            org.objectweb.asm.MethodVisitor nextMethodVisitor,
                            java.lang.String methodName,
                            java.lang.String methodSignature)

Description copied from interface: TouchPointListener

after LINENUMBER instruction was processed.

Specified by:

afterLineNumber in interface TouchPointListener

Parameters:

eventId - - id of the detected event.

label - - label connected to the line

currentLine - - number of currently visited line

nextMethodVisitor - - sink for instrumented code

methodName - - name of currently being instrumented method

methodSignature - - signature (params and returned value type) of currently being instrumented method

beforeSwitch

public void beforeSwitch(int eventId,
                         org.objectweb.asm.Label def,
                         org.objectweb.asm.Label[] labels,
                         int currentLine,
                         org.objectweb.asm.MethodVisitor mv,
                         java.lang.String conditionType)

Description copied from interface: TouchPointListener

Called befere processing switch statement.

Specified by:

beforeSwitch in interface TouchPointListener

Parameters:

eventId - - id of the detected event.

def - - label of 'default' target label that will be used when none of given values match the switch

labels - - table of labels connected to switch 'values' (different switch branches). There might be duplicates in the table (fall-through in switch statement)

currentLine - - number of line in which the 'switch' keyword has been found (number of line currently being processed)

mv - - sink for instrumented (injected) code

conditionType - - NULL (if undetected) or signature of variable used as a switch condition. *

ignoreLine

public void ignoreLine(int eventId,
                       int currentLine)

Description copied from interface: TouchPointListener

If we determined that some line should be not 'counted' by cobertura (for example the line might be specified in AbstractFindTouchPointsClassInstrumenter.ignoreRegexp) we call this method.

It's possible that TouchPointListener.afterLineNumber(int, Label, int, MethodVisitor, String, String) event will be (or has been already) fired.

Specified by:

ignoreLine in interface TouchPointListener

Parameters:

eventId - - id of the event connected to the line (the same eventId that might be used for the line in TouchPointListener.afterLineNumber(int, Label, int, MethodVisitor, String, String))

currentLine - - number of line that should be ignored.

afterJump

public void afterJump(int eventId,
                      org.objectweb.asm.Label label,
                      int currentLine,
                      org.objectweb.asm.MethodVisitor nextMethodVisitor)

Description copied from interface: TouchPointListener

Before code responsible for realizing 'interesting' JUMP

JUMP event is not called in case of GOTO and RETURN instruction (not conditional JUMPS)

Specified by:

afterJump in interface TouchPointListener

Parameters:

eventId - - id of the detected event.

label - - destination label of the jump

currentLine - - number of currently visited line

nextMethodVisitor - - sink for instrumented code

afterLabel

public void afterLabel(int eventId,
                       org.objectweb.asm.Label label,
                       int currentLine,
                       org.objectweb.asm.MethodVisitor mv)

Description copied from interface: TouchPointListener

Called before processing 'label' directive

Specified by:

afterLabel in interface TouchPointListener

Parameters:

eventId - - id of the detected event.

label - - internal identifier of label being found (single pass of instrumentation valid only)

currentLine - - number of line in which the 'switch' keyword has been found (number of line currently being processed)

mv - - sink for instrumented (injected) code

afterMethodStart

public void afterMethodStart(org.objectweb.asm.MethodVisitor nextMethodVisitor)

Description copied from interface: TouchPointListener

Event called when a new method have been just started for instrumentation. It is called after method declaration has been read, but before 'a real' code has been processed.

Specified by:

afterMethodStart in interface TouchPointListener

Parameters:

nextMethodVisitor - - sink for instrumented code