Module org.glassfish.hk2.core

Package com.sun.enterprise.module.single

Class ClassPathBasedModulesRegistry

java.lang.Object

com.sun.enterprise.module.common_impl.AbstractModulesRegistryImpl

com.sun.enterprise.module.impl.ModulesRegistryImpl

com.sun.enterprise.module.single.ClassPathBasedModulesRegistry

All Implemented Interfaces:

ModuleChangeListener, ModulesRegistry

public class ClassPathBasedModulesRegistry
extends ModulesRegistryImpl

Implements a modules registry based on a class-path style of module description using a single class loader (capable of loading the entire class-path)

Author:

Jerome Dochez

Field Summary

Fields inherited from class com.sun.enterprise.module.common_impl.AbstractModulesRegistryImpl

parent, providers, repositories

Constructor Summary

Constructors

Constructor	Description
ClassPathBasedModulesRegistry(ClassLoader singleCL, String classPath)

Method Summary

Modifier and Type	Method	Description
HK2Module	find(Class clazz)	Finds the HK2Module that owns the given class.
Collection<HK2Module>	getModules()	Returns the list of shared Modules registered in this instance.
Collection<HK2Module>	getModules(String moduleName)	Returns the list of shared Modules registered in this instance whose name matches the given name
HK2Module	makeModuleFor(String name, String version, boolean resolve)	Returns the HK2Module instance giving a name and version constraints.
protected List<org.glassfish.hk2.api.ActiveDescriptor>	parseInhabitants(HK2Module module, String name, org.glassfish.hk2.api.ServiceLocator serviceLocator, List<org.glassfish.hk2.api.PopulatorPostProcessor> postProcessors)

Methods inherited from class com.sun.enterprise.module.impl.ModulesRegistryImpl

createChild, detachAll, getLifecycleListeners, getModulesClassLoader, getModulesClassLoader, getParentClassLoader, getProvidingModule, newModule, register, setParentClassLoader, shutdown, unregister

Methods inherited from class com.sun.enterprise.module.common_impl.AbstractModulesRegistryImpl

add, add, add, addRepository, addRepository, changed, createServiceLocator, createServiceLocator, createServiceLocator, dumpState, getAllServiceLocators, getModulesProvider, getProvidersClass, getRepository, getRunningServices, initializeServiceLocator, loadFromRepository, makeModuleFor, makeModuleFor, newServiceLocator, newServiceLocator, populateConfig, populateServiceLocator, print, registerRunningService, remove, removeRepository, unregisterRunningService

Methods inherited from class java.lang.Object

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

Constructor Details

ClassPathBasedModulesRegistry

public ClassPathBasedModulesRegistry(ClassLoader singleCL,
 String classPath)
                              throws IOException

Throws:

IOException

Method Details

find

public HK2Module find(Class clazz)

Description copied from interface: ModulesRegistry

Finds the HK2Module that owns the given class.

Specified by:

find in interface ModulesRegistry

Overrides:

find in class ModulesRegistryImpl

Returns:

null if the class is loaded outside the module system.

getModules

public Collection<HK2Module> getModules(String moduleName)

Description copied from interface: ModulesRegistry

Returns the list of shared Modules registered in this instance whose name matches the given name

The returned list will not include the modules defined in the ancestor ModulesRegistrys.

Specified by:

getModules in interface ModulesRegistry

Overrides:

getModules in class AbstractModulesRegistryImpl

Returns:

an umodifiable list of loaded modules having names that match the given name

getModules

public Collection<HK2Module> getModules()

Description copied from class: AbstractModulesRegistryImpl

Returns the list of shared Modules registered in this instance.

The returned list will not include the modules defined in the ancestor AbstractModulesRegistryImpls.

Specified by:

getModules in interface ModulesRegistry

Overrides:

getModules in class AbstractModulesRegistryImpl

Returns:

an umodifiable list of loaded modules

makeModuleFor

public HK2Module makeModuleFor(String name,
 String version,
 boolean resolve)
                        throws ResolveError

Description copied from interface: ModulesRegistry

Returns the HK2Module instance giving a name and version constraints.

Specified by:

makeModuleFor in interface ModulesRegistry

Overrides:

makeModuleFor in class AbstractModulesRegistryImpl

Parameters:

name - the module name

version - the module version. Caller should specify a correct version.

resolve - should the module be resolved or not

Returns:

the module instance or null if none can be found

Throws:

ResolveError - if the module dependencies cannot be resolved

parseInhabitants

protected List<org.glassfish.hk2.api.ActiveDescriptor> parseInhabitants(HK2Module module,
 String name,
 org.glassfish.hk2.api.ServiceLocator serviceLocator,
 List<org.glassfish.hk2.api.PopulatorPostProcessor> postProcessors)
                                                                 throws IOException

Overrides:

parseInhabitants in class ModulesRegistryImpl

Throws:

IOException