InstrumentingClassLoader (Java Instrumentation API)

java.lang.Object
- java.lang.ClassLoader
- - java.security.SecureClassLoader
  - - java.net.URLClassLoader
    - - alt.jiapi.util.InstrumentingClassLoader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable
```
public class InstrumentingClassLoader
extends java.net.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?

Version:

$Revision: 1.7 $ $Date: 2006/01/31 12:53:04 $

Author:

Mika Riekkinen, Joni Suominen

Field Summary

Fields
Modifier and Type Field and Description

protected java.util.Map classes

protected InstrumentationContext ctx

Fields
Modifier and Type	Field and Description
`protected java.util.Map`	`classes`
`protected InstrumentationContext`	`ctx`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`InstrumentingClassLoader(InstrumentationContext ctx, java.net.URL[] urls, java.lang.ClassLoader parent)`

Method Summary

Methods
Modifier and Type	Method and Description
`java.lang.Class`	`bootstrap(java.lang.String className)`
`static java.lang.ClassLoader`	`createClassLoader()` Creates a new InstrumentingClassloader.
`static java.lang.ClassLoader`	`createClassLoader(InstrumentationContext ctx)` Creates a new InstrumentingClassloader.
`static java.lang.ClassLoader`	`createClassLoader(InstrumentationContext ctx, java.lang.ClassLoader parent)` Creates a new InstrumentingClassloader.
`static java.lang.ClassLoader`	`createClassLoader(InstrumentationContextProvider icp)` Creates a new InstrumentingClassloader.
`static java.lang.ClassLoader`	`createClassLoader(InstrumentationContextProvider icp, java.lang.ClassLoader parent)` Creates a new InstrumentingClassloader.
`protected java.security.CodeSource`	`createCodeSource(java.net.URL location)` Form a CodeSource for loaded class.
`java.lang.Class`	`findClass(java.lang.String name)`
`protected java.lang.Class`	`loadClass(java.lang.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 java.util.Map classes
```

ctx
```
protected InstrumentationContext ctx
```

Constructor Detail

InstrumentingClassLoader

protected InstrumentingClassLoader(InstrumentationContext ctx,
                        java.net.URL[] urls,
                        java.lang.ClassLoader parent)

Method Detail

bootstrap

public java.lang.Class bootstrap(java.lang.String className)
                          throws java.lang.ClassNotFoundException

Throws:: java.lang.ClassNotFoundException