Class FileSystemClassInformationRepository

java.lang.Object

com.offbynull.coroutines.instrumenter.asm.FileSystemClassInformationRepository

All Implemented Interfaces:

ClassInformationRepository

public final class FileSystemClassInformationRepository
extends Object
implements ClassInformationRepository

Provides information on classes contained within JARs and folders.

Author:

Kasra Faghihi

Constructor Summary

Constructors

Constructor	Description
FileSystemClassInformationRepository()

Method Summary

Modifier and Type	Method	Description
void	addClasspath(List<File> classpath)	Add classes contained within a list of JAR files and folders.
void	addIndividual(String className, ClassInformation classInformation)	Add a custom class.
static FileSystemClassInformationRepository	create(List<File> initialClasspath)	Constructs a FileSystemClassInformationRepository object and loads it up with the classes in a classpath.
ClassInformation	getInformation(String internalClassName)	Get information for a class.

Methods inherited from class Object

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

Constructor Details

FileSystemClassInformationRepository

public FileSystemClassInformationRepository()

Method Details

create

public static FileSystemClassInformationRepository create(List<File> initialClasspath)
                                                   throws IOException

Constructs a FileSystemClassInformationRepository object and loads it up with the classes in a classpath.

Parameters:

initialClasspath - classpath to scan for class information (can be JAR files and/or folders)

Returns:

newly created FileSystemClassInformationRepository object

Throws:

NullPointerException - if any argument is null or contains null elements

IOException - if an IO error occurs

getInformation

public ClassInformation getInformation(String internalClassName)

Description copied from interface: ClassInformationRepository

Get information for a class.

This method returns class information as if it were encountered in a class file. In a class file, if the class is an interface, then its superclass is set to Object. Note that this is different from what Class.getSuperclass() returns when the class represents an interface (it returns null).

Specified by:

getInformation in interface ClassInformationRepository

Parameters:

internalClassName - internal class name

Returns:

information for that class, or null if not found

addIndividual

public void addIndividual(String className,
 ClassInformation classInformation)

Add a custom class.

Parameters:

className - name of class

classInformation - information for class

Throws:

NullPointerException - if any argument is null

IllegalArgumentException - if className already exists in this repository

addClasspath

public void addClasspath(List<File> classpath)
                  throws IOException

Add classes contained within a list of JAR files and folders. Note that if a duplicate class is encountered, the original is kept.

Parameters:

classpath - list of JARs and folders to scan

Throws:

NullPointerException - if any argument is null or contains null elements

IOException - if an IO error occurs