org.evomaster.client.java.instrumentation

Class InstrumentingClassLoader

java.lang.Object

java.lang.ClassLoader

org.evomaster.client.java.instrumentation.InstrumentingClassLoader

public class InstrumentingClassLoader
extends ClassLoader

This classloader will add probes to the loaded classes. Although such probes might make the classes slower to execute, these probes should not change the behavior of the instrumented classes. If they do, then it is either a problem related to timing, or a bug in this library.
This is needed ONLY when the test cases are generated, and not when they are run.
Note: this class loader can only be used during testing of EM. For user controllers, we have to use a Java Agent that can intercept ALL class loading. The problem is that there are some packages we cannot instrument (eg javax.) otherwise it becomes a nightmare to handle. But those packages could use reflection to load classes that we do instrument. In the moment we delegate to super classloader for those packages, we are screwed, as some classes could be loaded twice. An example is in javax.validation.Validation which can re-load hibernate classes by searching for "default providers".

Constructor Summary

Constructors

Constructor and Description
InstrumentingClassLoader(String packagePrefixesToCover) Classloader needed to bootstrap the execution of your application.

Method Summary

Modifier and Type	Method and Description
boolean	isCrashWhenFailedInstrumentation()
Class<?>	loadClass(String name)
void	setCrashWhenFailedInstrumentation(boolean crashWhenFailedInstrumentation)

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findResources, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Constructor Detail

InstrumentingClassLoader

public InstrumentingClassLoader(String packagePrefixesToCover)
                         throws IllegalArgumentException

Classloader needed to bootstrap the execution of your application. This is needed because it will apply bytecode instrumentation to keep track of which parts of the code is executed, and to inject heuristics to help the generation of test cases that maximize coverage

Parameters:

packagePrefixesToCover: - a "," separated list of package prefixes or class names. For example, "com.foo.,com.bar.Bar". Note: be careful of using something as generate as "com." or "org.", as most likely ALL your third-party libraries would be instrumented as well, which could have a severe impact on performance

Throws:

IllegalArgumentException - if packagePrefixesToCover is invalid

Method Detail

loadClass

public Class<?> loadClass(String name)
                   throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

isCrashWhenFailedInstrumentation

public boolean isCrashWhenFailedInstrumentation()

setCrashWhenFailedInstrumentation

public void setCrashWhenFailedInstrumentation(boolean crashWhenFailedInstrumentation)