org.codehaus.groovy.tools
Class LoaderConfiguration

java.lang.Object
  org.codehaus.groovy.tools.LoaderConfiguration

public class LoaderConfiguration
extends java.lang.Object

Class used to configure a RootLoader from a stream or by using it's methods.

The stream can be for example a FileInputStream from a file with the following format:

 # comment
 main is classname
 load path
 load file
 load pathWith${property}
 load pathWith!{required.property}
 load path/*.jar
 load path/**/*.jar
 

• All lines starting with "#" are ignored.
• The "main is" part may only be once in the file. The String afterwards is the name of a class with a main method.
• The "load" command will add the given file or path to the classpath in this configuration object. If the path does not exist, the path will be ignored.
• properties referenced using !{x} are required.
• properties referenced using ${x} are not required. If the property does not exist the whole load instruction line will be ignored.
• * is used to match zero or more characters in a file.
• ** is used to match zero or more directories.

Defining the main class is required unless setRequireMain(boolean) is called with false, before reading the configuration. You can use the wildcard "*" to filter the path, but only for files, not directories. To match directories use "**". The ${propertyname} is replaced by the value of the system's property name. You can use user.home here for example. If the property does not exist, an empty string will be used. If the path or file after the load command does not exist, the path will be ignored.

Version:

$Revision: 14870 $

Author:

Jochen Theodorou

See Also:

RootLoader

Field Summary

private static java.lang.String	ALL_WILDCARD
private java.util.List	classPath
private static java.lang.String	LOAD_PREFIX
private java.lang.String	main
private static java.lang.String	MAIN_PREFIX
private static java.lang.String	MATCH_ALL
private static java.lang.String	MATCH_FILE_NAME
private boolean	requireMain
private static char	WILDCARD

Constructor Summary

LoaderConfiguration()
creates a new loader configuration

Method Summary

void	addClassPath(java.lang.String path) Adds a classpath to this configuration.
void	addFile(java.io.File file) Adds a file to the classpath if it exists.
void	addFile(java.lang.String filename) Adds a file to the classpath if it exists.
private java.lang.String	assignProperties(java.lang.String str)
void	configure(java.io.InputStream is) configures this loader with a stream
private void	findMatchingFiles(java.io.File[] files, java.util.regex.Pattern pattern, boolean recursive)
java.net.URL[]	getClassPathUrls() The classpath as URL[] from this configuration.
java.lang.String	getMainClass() Returns the name of the main class for this configuration.
private java.lang.String	getParentPath(java.lang.String filter)
private java.lang.String	getSlashyPath(java.lang.String path)
private void	loadFilteredPath(java.lang.String filter)
private boolean	parentPathDoesExist(java.lang.String path)
void	setMainClass(java.lang.String classname) Sets the main class.
void	setRequireMain(boolean requireMain) Determines if a main class is required when calling.

Methods inherited from class java.lang.Object

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

Field Detail

MAIN_PREFIX

private static final java.lang.String MAIN_PREFIX

See Also:

Constant Field Values

LOAD_PREFIX

private static final java.lang.String LOAD_PREFIX

See Also:

Constant Field Values

classPath

private java.util.List classPath

main

private java.lang.String main

requireMain

private boolean requireMain

WILDCARD

private static final char WILDCARD

See Also:

Constant Field Values

ALL_WILDCARD

private static final java.lang.String ALL_WILDCARD

See Also:

Constant Field Values

MATCH_FILE_NAME

private static final java.lang.String MATCH_FILE_NAME

See Also:

Constant Field Values

MATCH_ALL

private static final java.lang.String MATCH_ALL

See Also:

Constant Field Values

Constructor Detail

LoaderConfiguration

public LoaderConfiguration()

creates a new loader configuration

Method Detail

configure

public void configure(java.io.InputStream is)
               throws java.io.IOException

configures this loader with a stream

Parameters:

is - stream used to read the configuration

Throws:

java.io.IOException - if reading or parsing the contents of the stream fails

assignProperties

private java.lang.String assignProperties(java.lang.String str)

loadFilteredPath

private void loadFilteredPath(java.lang.String filter)

findMatchingFiles

private void findMatchingFiles(java.io.File[] files,
                               java.util.regex.Pattern pattern,
                               boolean recursive)

getSlashyPath

private java.lang.String getSlashyPath(java.lang.String path)

parentPathDoesExist

private boolean parentPathDoesExist(java.lang.String path)

getParentPath

private java.lang.String getParentPath(java.lang.String filter)

addFile

public void addFile(java.io.File file)

Adds a file to the classpath if it exists.

Parameters:

file - the file to add

addFile

public void addFile(java.lang.String filename)

Adds a file to the classpath if it exists.

Parameters:

filename - the name of the file to add

addClassPath

public void addClassPath(java.lang.String path)

Adds a classpath to this configuration. It expects a string with multiple paths, seperated by the system dependent path separator

Parameters:

path - the path as a path separator delimited string

See Also:

File.pathSeparator

getClassPathUrls

public java.net.URL[] getClassPathUrls()

The classpath as URL[] from this configuration. This can be used to construct a class loader.

Returns:

the classpath

See Also:

URLClassLoader

getMainClass

public java.lang.String getMainClass()

Returns the name of the main class for this configuration.

Returns:

the name of the main class or null if not defined

setMainClass

public void setMainClass(java.lang.String classname)

Sets the main class. If there is already a main class it is overwritten. Calling @see #configure(InputStream) after calling this method does not require a main class definition inside the stream.

Parameters:

classname - the name to become the main class

setRequireMain

public void setRequireMain(boolean requireMain)

Determines if a main class is required when calling.

Parameters:

requireMain - set to false if no main class is required

See Also:

configure(InputStream)