net.sf.jiapi.reflect.util

Class InstrumentingClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

net.sf.jiapi.reflect.util.InstrumentingClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public class InstrumentingClassLoader
extends URLClassLoader

A sample ClassLoader which can be used when instrumenting Java applications. It knows how to load classes from CLASSPATH.

NOTE: Should the jar files found from jre/lib/ext (System.getProperty("java.ext.dirs")) also be added to search path?

Author:

Mika Riekkinen, Joni Suominen

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,Class<?>>	classes
protected InstrumentationContext	ctx

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InstrumentingClassLoader(InstrumentationContext ctx, URL[] urls, ClassLoader parent)

Method Summary

Modifier and Type	Method and Description
Class<?>	bootstrap(String className)
static ClassLoader	createClassLoader() Creates a new InstrumentingClassloader.
static ClassLoader	createClassLoader(InstrumentationContext ctx) Creates a new InstrumentingClassloader.
static ClassLoader	createClassLoader(InstrumentationContext ctx, ClassLoader parent) Creates a new InstrumentingClassloader.
static ClassLoader	createClassLoader(InstrumentationContextProvider icp) Creates a new InstrumentingClassloader.
static ClassLoader	createClassLoader(InstrumentationContextProvider icp, ClassLoader parent) Creates a new InstrumentingClassloader.
protected CodeSource	createCodeSource(URL location) Form a CodeSource for loaded class.
Class<?>	findClass(String name)
protected Class<?>	loadClass(String className, boolean resolve)
void	setContext(InstrumentationContext ctx) Set the context for the ClassLoader.

Methods inherited from class java.net.URLClassLoader

addURL, close, definePackage, findResource, findResources, getPermissions, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, 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

Field Detail

classes

protected Map<String,Class<?>> classes

ctx

protected InstrumentationContext ctx

Constructor Detail

InstrumentingClassLoader

protected InstrumentingClassLoader(InstrumentationContext ctx,
                                   URL[] urls,
                                   ClassLoader parent)

Method Detail

createClassLoader

public static ClassLoader createClassLoader()

Creates a new InstrumentingClassloader.

Returns:

a ClassLoader

createClassLoader

public static ClassLoader createClassLoader(InstrumentationContextProvider icp)
                                     throws JiapiException

Creates a new InstrumentingClassloader.

Parameters:

icp - InstrumentationContextProvider

Returns:

a ClassLoader

Throws:

JiapiException - on error

createClassLoader

public static ClassLoader createClassLoader(InstrumentationContextProvider icp,
                                            ClassLoader parent)
                                     throws JiapiException

Creates a new InstrumentingClassloader.

Parameters:

icp - InstrumentationContextProvider

parent - Parent ClassLoader

Returns:

a ClassLoader

Throws:

JiapiException - on error

createClassLoader

public static ClassLoader createClassLoader(InstrumentationContext ctx)

Creates a new InstrumentingClassloader.

Parameters:

ctx - InstrumentationContext

Returns:

a ClassLoader

createClassLoader

public static ClassLoader createClassLoader(InstrumentationContext ctx,
                                            ClassLoader parent)

Creates a new InstrumentingClassloader.

Parameters:

ctx - InstrumentationContext

parent - Parent ClassLoader

Returns:

a ClassLoader

loadClass

protected Class<?> loadClass(String className,
                             boolean resolve)
                      throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

createCodeSource

protected CodeSource createCodeSource(URL location)

Form a CodeSource for loaded class.

Parameters:

location - a location where the class was loaded from

Returns:

CodeSource

setContext

public void setContext(InstrumentationContext ctx)

Set the context for the ClassLoader.

Parameters:

ctx - an InstrumentationContext to be used

bootstrap

public Class<?> bootstrap(String className)
                   throws ClassNotFoundException

Throws:

ClassNotFoundException

findClass

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

Overrides:

findClass in class URLClassLoader

Throws:

ClassNotFoundException