jas.engine
Class DynamicClassLoader

java.lang.Object
  java.lang.ClassLoader
      jas.engine.DynamicClassLoader

public class DynamicClassLoader
extends java.lang.ClassLoader

A customized class loader. When JAS loads a project file, the classes specified by the project file can be everywhere on the file system. Into the project file there are the paths where to find model's classes. Often these classpaths are not system classpaths, so to let the engine load dinamically models it is necessary to use this dynamic class loader.

When the loadClass method is called the ClassLoader asks to the system class loader if the given class is available in the system classpath, otherwise the class is searched into the paths specified by the project file.

Title: JAS

Description: Java Agent-based Simulation library

Copyright (C) 2002 Michele Sonnessa

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

Author:

Michele Sonnessa

Constructor Summary

DynamicClassLoader()
Default constructor.

Method Summary

void	addPath(java.io.File directory) Add the directory into the local classpath.
void	clearPaths() Empty local classpath list.
java.io.File	getClassPath(java.lang.String name) Return the directory where class file is stored.
DynamicClassLoader	getClearClone()
java.util.Set	getJarPaths() Return a set of jar archives contained in the local classpath.
java.util.Set	getPaths() Return a set of directories contained in the local classpath.
void	removePath(java.io.File directory) Remove directory from the local classpath.

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus

Methods inherited from class java.lang.Object

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

Constructor Detail

DynamicClassLoader

public DynamicClassLoader()

Default constructor.

Method Detail

addPath

public void addPath(java.io.File directory)

Add the directory into the local classpath.

Parameters:

directory - The directory or the jar file to be added to classpath.

clearPaths

public void clearPaths()

Empty local classpath list.

getClassPath

public java.io.File getClassPath(java.lang.String name)

Return the directory where class file is stored.

Parameters:

name - The string representing class file name (without extension).

Returns:

The File object representing the home directory of the class.

getClearClone

public DynamicClassLoader getClearClone()

getJarPaths

public java.util.Set getJarPaths()

Return a set of jar archives contained in the local classpath.

Returns:

A set of File objects representing jar files.

getPaths

public java.util.Set getPaths()

Return a set of directories contained in the local classpath.

Returns:

A set of File objects representing directories.

removePath

public void removePath(java.io.File directory)

Remove directory from the local classpath.

Parameters:

directory - The directory or the jar file to be removed.