org.codehaus.classworlds
Class Configurator

java.lang.Object
  |
  +--org.codehaus.classworlds.Configurator

public class Configurator
extends java.lang.Object

Launcher configurator.

Version:
$Id: Configurator.java,v 1.3 2004/09/07 13:17:42 brett Exp $
Author:
bob mcwhirter, Jason van Zyl

Field Summary
static java.lang.String IMPORT_PREFIX
           
static java.lang.String LOAD_PREFIX
           
static java.lang.String MAIN_PREFIX
           
static java.lang.String OPTIONALLY_PREFIX
          Optionally spec prefix.
static java.lang.String SET_PREFIX
           
 
Constructor Summary
Configurator(ClassWorld world)
          Construct.
Configurator(Launcher launcher)
          Construct.
 
Method Summary
protected  void associateRealms()
          Associate parent realms with their children.
 void configure(java.io.InputStream is)
          Configure from a file.
protected  java.lang.String filter(java.lang.String text)
          Filter a string for system properties.
protected  void loadGlob(java.lang.String line, ClassRealm realm)
          Load a glob into the specified classloader.
protected  void loadGlob(java.lang.String line, ClassRealm realm, boolean optionally)
          Load a glob into the specified classloader.
 void setClassWorld(ClassWorld world)
          set world.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

MAIN_PREFIX

public static final java.lang.String MAIN_PREFIX
See Also:
Constant Field Values

SET_PREFIX

public static final java.lang.String SET_PREFIX
See Also:
Constant Field Values

IMPORT_PREFIX

public static final java.lang.String IMPORT_PREFIX
See Also:
Constant Field Values

LOAD_PREFIX

public static final java.lang.String LOAD_PREFIX
See Also:
Constant Field Values

OPTIONALLY_PREFIX

public static final java.lang.String OPTIONALLY_PREFIX
Optionally spec prefix.

See Also:
Constant Field Values
Constructor Detail

Configurator

public Configurator(Launcher launcher)
Construct.

Parameters:
launcher - The launcher to configure.

Configurator

public Configurator(ClassWorld world)
Construct.

Method Detail

setClassWorld

public void setClassWorld(ClassWorld world)
set world. this setter is provided so you can use the same configurator to configure several "worlds"


configure

public void configure(java.io.InputStream is)
               throws java.io.IOException,
                      java.net.MalformedURLException,
                      ConfigurationException,
                      DuplicateRealmException,
                      NoSuchRealmException
Configure from a file.

Parameters:
is - The config input stream
Throws:
java.io.IOException - If an error occurs reading the config file.
java.net.MalformedURLException - If the config file contains invalid URLs.
ConfigurationException - If the config file is corrupt.
DuplicateRealmException - If the config file defines two realms with the same id.
NoSuchRealmException - If the config file defines a main entry point in a non-existent realm.

associateRealms

protected void associateRealms()
Associate parent realms with their children.


loadGlob

protected void loadGlob(java.lang.String line,
                        ClassRealm realm)
                 throws java.net.MalformedURLException,
                        java.io.FileNotFoundException
Load a glob into the specified classloader.

Parameters:
line - The path configuration line.
realm - The realm to populate
Throws:
java.net.MalformedURLException - If the line does not represent a valid path element.
java.io.FileNotFoundException - If the line does not represent a valid path element in the filesystem.

loadGlob

protected void loadGlob(java.lang.String line,
                        ClassRealm realm,
                        boolean optionally)
                 throws java.net.MalformedURLException,
                        java.io.FileNotFoundException
Load a glob into the specified classloader.

Parameters:
line - The path configuration line.
realm - The realm to populate
optionally - Whether the path is optional or required
Throws:
java.net.MalformedURLException - If the line does not represent a valid path element.
java.io.FileNotFoundException - If the line does not represent a valid path element in the filesystem.

filter

protected java.lang.String filter(java.lang.String text)
                           throws ConfigurationException
Filter a string for system properties.

Parameters:
text - The text to filter.
Returns:
The filtered text.
Throws:
ConfigurationException - If the property does not exist or if there is a syntax error.


Copyright © 2002-2004 The Codehaus. All Rights Reserved.