Field Detail

• protected final Map classCache

  this cache contains the loaded classes or PARSING, if the class is currently parsed

• protected final Map sourceCache

  This cache contains mappings of file name to class. It is used to bypass compilation.

Constructor Detail

• public GroovyClassLoader()

  creates a GroovyClassLoader using the current Thread's context Class loader as parent.

• public GroovyClassLoader(ClassLoader loader)

  creates a GroovyClassLoader using the given ClassLoader as parent

• public GroovyClassLoader(GroovyClassLoader parent)

  creates a GroovyClassLoader using the given GroovyClassLoader as parent. This loader will get the parent's CompilerConfiguration

• public GroovyClassLoader(ClassLoader parent, CompilerConfiguration config, boolean useConfigurationClasspath)

  creates a GroovyClassLoader.

  Parameters:

  parent - the parent class loader

  config - the compiler configuration

  useConfigurationClasspath - determines if the configurations classpath should be added

• public GroovyClassLoader(ClassLoader loader, CompilerConfiguration config)

  creates a GroovyClassLoader using the given ClassLoader as parent.

Method Detail

• public void addClasspath(String path)

• public void addURL(URL url)

• public void clearCache()

• protected GroovyClassLoader.ClassCollector createCollector(CompilationUnit unit, SourceUnit su)

• protected CompilationUnit createCompilationUnit(CompilerConfiguration config, CodeSource source)

• public Class defineClass(ClassNode classNode, String file, String newCodeBase)

  Loads the given class node returning the implementation Class.

  WARNING: this compilation is not synchronized

  Parameters:

  classNode

  Returns:

  a class

• public Class defineClass(String name, byte[] b)

• public String generateScriptName()

• protected Class getClassCacheEntry(String name)

• protected String[] getClassPath()

  gets the currently used classpath.

  Returns:

  a String[] containing the file information of the urls

  See Also:

  getURLs()

• public Class[] getLoadedClasses()

• protected PermissionCollection getPermissions(CodeSource codeSource)

• public GroovyResourceLoader getResourceLoader()

• protected long getTimeStamp(Class cls)

• protected boolean isRecompilable(Class cls)

• public Boolean isShouldRecompile()

• protected boolean isSourceNewer(URL source, Class cls)

  adds a classpath to this classloader.

  Parameters:

  path - is a jar file or a directory.

  See Also:

  addURL(URL)

• public Class loadClass(String name, boolean lookupScriptFiles, boolean preferClassOverScript)

• public Class loadClass(String name, boolean lookupScriptFiles, boolean preferClassOverScript, boolean resolve)

• @Overrideprotected long getTimeStamp(Class cls) { public Class loadClass(String name)

  Implemented here to check package access prior to returning an already loaded class.

  throws:

  CompilationFailedException if the compilation failed

  throws:

  ClassNotFoundException if the class was not found

  See Also:

  ClassLoader.loadClass

• protected Class loadClass(String name, boolean resolve)

  This method will take a file name and try to "decode" any URL encoded characters. For example if the file name contains any spaces this method call will take the resulting %20 encoded values and convert them to spaces.

  This method was added specifically to fix defect: Groovy-1787. The defect involved a situation where two scripts were sitting in a directory with spaces in its name. The code would fail when the class loader tried to resolve the file name and would choke on the URLEncoded space values.

• public Class parseClass(File file)

  Parses the given file into a Java class capable of being run

  Parameters:

  file - the file name to parse

  Returns:

  the main class defined in the given script

• public Class parseClass(String text, String fileName)

  Parses the given text into a Java class capable of being run

  Parameters:

  text - the text of the script/class to parse

  fileName - the file name to use as the name of the class

  Returns:

  the main class defined in the given script

• public Class parseClass(String text)

  Parses the given text into a Java class capable of being run

  Parameters:

  text - the text of the script/class to parse

  Returns:

  the main class defined in the given script

• public Class parseClass(InputStream in, String fileName)

  deprecated:

  Prefer using methods taking a Reader rather than an InputStream to avoid wrong encoding issues.

• public Class parseClass(GroovyCodeSource codeSource)

• public Class parseClass(GroovyCodeSource codeSource, boolean shouldCacheSource)

• protected Class recompile(URL source, String className, Class oldClass)

  (Re)Compiles the given source. This method starts the compilation of a given source, if the source has changed since the class was created. For this isSourceNewer is called.

  throws:

  CompilationFailedException if the compilation failed

  throws:

  IOException if the source is not readable

  Parameters:

  source - the source pointer for the compilation

  className - the name of the class to be generated

  oldClass - a possible former class

  Returns:

  the old class if the source wasn't new enough, the new class else

  See Also:

  isSourceNewer(URL, Class)

• protected void removeClassCacheEntry(String name)

• protected void setClassCacheEntry(Class cls)

• public void setResourceLoader(GroovyResourceLoader resourceLoader)

• public void setShouldRecompile(Boolean mode)

  sets if the recompilation should be enable. There are 3 possible values for this. Any value different than null overrides the value from the compiler configuration. true means to recompile if needed false means to never recompile.

  Parameters:

  mode - the recompilation mode

  See Also:

  CompilerConfiguration