java.lang.Object
org.gjt.sp.jedit.bsh.BshClassManager
org.gjt.sp.jedit.bsh.classpath.ClassManagerImpl
Manage all classloading in BeanShell.
Allows classpath extension and class file reloading.
This class holds the implementation of the BshClassManager so that it
can be separated from the core package.
This class currently relies on 1.2 for BshClassLoader and weak references.
Is there a workaround for weak refs? If so we could make this work
with 1.1 by supplying our own classloader code...
See "http://www.beanshell.org/manual/classloading.html" for details
on the bsh classloader architecture.
Bsh has a multi-tiered class loading architecture. No class loader is
created unless/until a class is generated, the classpath is modified,
or a class is reloaded.
Note: we may need some synchronization in here
Note on jdk1.2 dependency:
We are forced to use weak references here to accomodate all of the
fleeting namespace listeners. (NameSpaces must be informed if the class
space changes so that they can un-cache names). I had the interesting
thought that a way around this would be to implement BeanShell's own
garbage collector... Then I came to my senses and said - screw it,
class re-loading will require 1.2.
---------------------
Classloading precedence:
in-script evaluated class (scripted class)
in-script added / modified classpath
optionally, external classloader
optionally, thread context classloader
plain Class.forName()
source class (.java file in classpath)
-
Nested Class Summary
Nested classes/interfaces inherited from class org.gjt.sp.jedit.bsh.BshClassManager
BshClassManager.Listener -
Field Summary
Fields inherited from class org.gjt.sp.jedit.bsh.BshClassManager
absoluteClassCache, absoluteNonClasses, definingClasses, definingClassesBaseNames, externalClassLoader, resolvedObjectMethods, resolvedStaticMethods -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidaddClassPath(URL path) voidclassForName(String name) Load the specified class by name, taking into account added classpath and reloaded classes, etc.protected voidClear global class cache and notify namespaces to clear their class caches.defineClass(String name, byte[] code) Get the BeanShell classloader.voidSupport for "import *;" Hide details in here as opposed to NameSpace.voiddump(PrintWriter i) getClassNameByUnqName(String name) Return the name or null if none is found, Throw an ClassPathException containing detail if name is ambigous.Get the full blown classpath.getResource(String path) Get a resource URL using the BeanShell classpathgetResourceAsStream(String path) Get a resource stream using the BeanShell classpathprotected booleanA "super import" ("import *") operation has been performed.voidOverlay the entire path with a new class loader.voidreloadClasses(String[] classNames) Reloading classes means creating a new classloader and using it whenever we are asked for classes in the appropriate space.voidreloadPackage(String pack) Reload all classes in the specified package: e.g.voidvoidreset()Clear all classloading behavior and class caches and reset to initial state.voidsetClassPath(URL[] cp) Set a new base classpath and create a new base classloader.Methods inherited from class org.gjt.sp.jedit.bsh.BshClassManager
cacheClassInfo, cacheResolvedMethod, classExists, clearCaches, cmUnavailable, createClassManager, definingClass, doneDefiningClass, getClassBeingDefined, getResolvedMethod, isClassBeingDefined, loadSourceClass, noClassDefFound, plainClassForName, setClassLoader
-
Constructor Details
-
ClassManagerImpl
public ClassManagerImpl()Used by BshClassManager singleton constructor
-
-
Method Details
-
classForName
Description copied from class:BshClassManagerLoad the specified class by name, taking into account added classpath and reloaded classes, etc. Note: Again, this is just a trivial implementation. See bsh.classpath.ClassManagerImpl for the fully functional class management package.- Overrides:
classForNamein classBshClassManager- Returns:
- the class or null
-
getResource
Get a resource URL using the BeanShell classpath- Overrides:
getResourcein classBshClassManager- Parameters:
path- should be an absolute path
-
getResourceAsStream
Get a resource stream using the BeanShell classpath- Overrides:
getResourceAsStreamin classBshClassManager- Parameters:
path- should be an absolute path
-
addClassPath
- Overrides:
addClassPathin classBshClassManager- Throws:
IOException
-
reset
public void reset()Clear all classloading behavior and class caches and reset to initial state.- Overrides:
resetin classBshClassManager
-
setClassPath
Set a new base classpath and create a new base classloader. This means all types change.- Overrides:
setClassPathin classBshClassManager
-
reloadAllClasses
Overlay the entire path with a new class loader. Set the base path to the user path + base path. No point in including the boot class path (can't reload thos).- Overrides:
reloadAllClassesin classBshClassManager- Throws:
ClassPathException
-
reloadClasses
Reloading classes means creating a new classloader and using it whenever we are asked for classes in the appropriate space. For this we use a DiscreteFilesClassLoader- Overrides:
reloadClassesin classBshClassManager- Throws:
ClassPathException
-
reloadPackage
Reload all classes in the specified package: e.g. "com.sun.tools" The special package name "<unpackaged>" can be used to refer to unpackaged classes.- Overrides:
reloadPackagein classBshClassManager- Throws:
ClassPathException
-
getClassPath
Get the full blown classpath.- Throws:
ClassPathException
-
doSuperImport
Support for "import *;" Hide details in here as opposed to NameSpace.- Overrides:
doSuperImportin classBshClassManager- Throws:
UtilEvalError
-
hasSuperImport
protected boolean hasSuperImport()Description copied from class:BshClassManagerA "super import" ("import *") operation has been performed.- Overrides:
hasSuperImportin classBshClassManager
-
getClassNameByUnqName
Return the name or null if none is found, Throw an ClassPathException containing detail if name is ambigous.- Overrides:
getClassNameByUnqNamein classBshClassManager- Throws:
ClassPathException
-
addListener
- Overrides:
addListenerin classBshClassManager
-
removeListener
- Overrides:
removeListenerin classBshClassManager
-
getBaseLoader
-
defineClass
Get the BeanShell classloader. public ClassLoader getClassLoader() { }- Overrides:
defineClassin classBshClassManager
-
classLoaderChanged
protected void classLoaderChanged()Clear global class cache and notify namespaces to clear their class caches. The listener list is implemented with weak references so that we will not keep every namespace in existence forever.- Overrides:
classLoaderChangedin classBshClassManager
-
dump
- Overrides:
dumpin classBshClassManager
-