org.glassfish.hk2.utilities

Class ClasspathDescriptorFileFinder

java.lang.Object

org.glassfish.hk2.utilities.ClasspathDescriptorFileFinder

All Implemented Interfaces:

DescriptorFileFinder

public class ClasspathDescriptorFileFinder
extends Object
implements DescriptorFileFinder

This is an implementation of DescriptorFileFinder that uses a particular classloader in order to find descriptor files.

Author:

jwells

Field Summary

Fields inherited from interface org.glassfish.hk2.api.DescriptorFileFinder

RESOURCE_BASE

Constructor Summary

Constructors

Constructor and Description
ClasspathDescriptorFileFinder() If this constructor is used then HK2 descriptor files will be found by looking in the classpath of the process.
ClasspathDescriptorFileFinder(ClassLoader cl) This constructor can be used to select the particular classloader to search for HK2 descriptor files.
ClasspathDescriptorFileFinder(ClassLoader cl, String name) This constructor can be used to select the particular classloader to search for HK2 descriptor files.

Method Summary

Methods

Modifier and Type	Method and Description
List<InputStream>	findDescriptorFiles() Simple implementation of the findDescriptorFiles which does a simple getResources on the classloader in order to find the hk2 descriptor files
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ClasspathDescriptorFileFinder

public ClasspathDescriptorFileFinder()

If this constructor is used then HK2 descriptor files will be found by looking in the classpath of the process. The classloader used will be the classloader for this class itself. The names of the files found will be META-INF/hk2-locator/default.

This is most commonly used when using HK2 from a stand-alone client in which all the JAR files are on a single classpath

ClasspathDescriptorFileFinder

public ClasspathDescriptorFileFinder(ClassLoader cl)

This constructor can be used to select the particular classloader to search for HK2 descriptor files. The names of the the files found in this classloader will be META-INF/hk2-locator/default.

This is commonly used in more complex classloading scenarios where the HK2 descriptor files are not necessarily on the system classpath.

Parameters:

cl - May not be null and must be the classloader to use when searching for HK2 descriptor files

ClasspathDescriptorFileFinder

public ClasspathDescriptorFileFinder(ClassLoader cl,
                             String name)

This constructor can be used to select the particular classloader to search for HK2 descriptor files. The names of the the files found in this classloader will be META-INF/hk2-locator/name.

Parameters:

cl - May not be null and must be the classloader to use when searching for HK2 descriptor files

name - Maynot be null and must be the name of the files to search for in the META-INF/hk2-locator directory

Method Detail

findDescriptorFiles

public List<InputStream> findDescriptorFiles()
                                      throws IOException

Simple implementation of the findDescriptorFiles which does a simple getResources on the classloader in order to find the hk2 descriptor files

Specified by:

findDescriptorFiles in interface DescriptorFileFinder

Returns:

A non-null (but possibly empty) list of InputStreams for hk2 inhabitant files

Throws:

IOException - If there was an error finding the hk2 inhabitant files

toString

public String toString()

Overrides:

toString in class Object