org.jace.proxy

Class ClassPath

java.lang.Object

org.jace.proxy.ClassPath

public class ClassPath
extends Object

A source for class files.

Author:

Toby Reyelts

Constructor Summary

Constructors

Constructor and Description
ClassPath(List<File> elements) Creates a new ClassPath.
ClassPath(String text) Creates a new ClassPath.

Method Summary

Methods

Modifier and Type	Method and Description
File	getFirstMatch(TypeName name) Returns the first match for name in the class path.
static void	main(String[] args) Tests ClassPath.
InputStream	openClass(TypeName name) Reads the supplied class path looking for the class name.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassPath

public ClassPath(List<File> elements)

Creates a new ClassPath.

Parameters:

elements - the paths to be used to search for classes

Throws:

IllegalArgumentException - if elements is null

ClassPath

public ClassPath(String text)

Creates a new ClassPath.

Parameters:

text - the String representation of the classpath

Throws:

IllegalArgumentException - if text is null

Method Detail

getFirstMatch

public File getFirstMatch(TypeName name)
                   throws IOException

Returns the first match for name in the class path. The class may be packed within a zip or jar file.

Parameters:

name - the class name

Returns:

the directory, zip or jar file containing the class file. Null if the class was not found.

Throws:

IOException - if an I/O error occurs while reading a zip or jar file

openClass

public InputStream openClass(TypeName name)
                      throws ClassNotFoundException,
                             IOException

Reads the supplied class path looking for the class name. Returns the InputStream to the class. (The class may be packed within a Zip or Jar file).

Parameters:

name - this may be any of the canonical styles of class naming

Returns:

the InputStream to the class

Throws:

ClassNotFoundException - if no matching class can be found.

IOException - if an error occurs while locating the class file

toString

public String toString()

Overrides:

toString in class Object

main

public static void main(String[] args)

Tests ClassPath.

Parameters:

args - the command-line argument