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, InhabitantsParserFactory

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

ClassPathBasedModulesRegistry(ClassLoader singleCL, String classPath)

Method Summary

Module	find(Class clazz) Finds the Module that owns the given class.
Collection<Module>	getModules() Returns the list of shared Modules registered in this instance.
Collection<Module>	getModules(String moduleName) Returns the list of shared Modules registered in this instance whose name matches the given name
Module	makeModuleFor(String name, String version, boolean resolve) Returns the Module instance giving a name and version constraints.
void	parseInhabitants(Module module, String name)

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, createInhabitantsParser, createServiceLocator, createServiceLocator, dumpState, getModulesProvider, getProvidersClass, getRepository, getRunningServices, initializeServiceLocator, loadFromRepository, makeModuleFor, makeModuleFor, newServiceLocator, newServiceLocator, print, registerRunningService, remove, removeRepository, unregisterRunningService

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassPathBasedModulesRegistry

public ClassPathBasedModulesRegistry(ClassLoader singleCL,
                                     String classPath)
                              throws IOException

Throws:

IOException

Method Detail

find

public Module find(Class clazz)

Description copied from interface: ModulesRegistry

Finds the Module 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<Module> 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<Module> 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 Module makeModuleFor(String name,
                            String version,
                            boolean resolve)
                     throws ResolveError

Description copied from interface: ModulesRegistry

Returns the Module 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

public void parseInhabitants(Module module,
                             String name)
                      throws IOException

Overrides:

parseInhabitants in class ModulesRegistryImpl

Throws:

IOException