com.gzoltar.core.instr

Class Instrumenter

java.lang.Object

com.gzoltar.core.instr.Instrumenter

public class Instrumenter
extends Object

Several APIs to instrument Java class definitions for coverage tracing.

Constructor Summary

Constructors

Constructor and Description
Instrumenter(AgentConfigs agentConfigs)

Method Summary

Modifier and Type	Method and Description
byte[]	instrument(byte[] classfileBuffer)
byte[]	instrument(javassist.CtClass cc)
int	instrument(File source, File dest)
byte[]	instrument(InputStream sourceStream)
int	instrumentRecursively(File source, File dest)
int	instrumentToFile(InputStream input, OutputStream output) Creates a instrumented version of the given resource depending on its type.
void	setRemoveSignatures(boolean flag) Determines whether signatures should be removed from JAR files.

Methods inherited from class java.lang.Object

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

Constructor Detail

Instrumenter

public Instrumenter(AgentConfigs agentConfigs)

Parameters:

agentConfigs -

Method Detail

setRemoveSignatures

public void setRemoveSignatures(boolean flag)

Determines whether signatures should be removed from JAR files. This is typically necessary as instrumentation modifies the class files and therefore invalidates existing JAR signatures. Default is true.

Parameters:

flag - true if signatures should be removed

instrument

public byte[] instrument(byte[] classfileBuffer)
                  throws Exception

Parameters:

classfileBuffer -

Returns:

Throws:

Exception

instrument

public byte[] instrument(InputStream sourceStream)
                  throws Exception

Parameters:

sourceStream -

Returns:

Throws:

Exception

instrument

public byte[] instrument(javassist.CtClass cc)
                  throws Exception

Parameters:

cc -

Returns:

Throws:

Exception

instrumentToFile

public int instrumentToFile(InputStream input,
                            OutputStream output)
                     throws Exception

Creates a instrumented version of the given resource depending on its type. Class files and the content of archive files (.zip, .jar) are instrumented. All other files are copied without modification.

Parameters:

input - stream to contents from

output - stream to write the instrumented version of the contents

Returns:

number of instrumented classes

Throws:

Exception - if reading data from the stream fails or a class cannot be instrumented

instrument

public int instrument(File source,
                      File dest)
               throws Exception

Throws:

Exception

instrumentRecursively

public int instrumentRecursively(File source,
                                 File dest)
                          throws Exception

Throws:

Exception