org.jvnet.hk2.osgiadapter
Class OSGiModulesRegistryImpl

java.lang.Object
  com.sun.enterprise.module.common_impl.AbstractModulesRegistryImpl
      org.jvnet.hk2.osgiadapter.OSGiModulesRegistryImpl

All Implemented Interfaces:

com.sun.enterprise.module.ModuleChangeListener, com.sun.enterprise.module.ModulesRegistry, java.util.EventListener, org.jvnet.hk2.component.HabitatFactory, org.jvnet.hk2.component.InhabitantsParserFactory, org.osgi.framework.BundleListener, org.osgi.framework.SynchronousBundleListener

public class OSGiModulesRegistryImpl
extends com.sun.enterprise.module.common_impl.AbstractModulesRegistryImpl
implements org.osgi.framework.SynchronousBundleListener

This is an implementation of ModulesRegistry. It uses OSGi extender pattern to do necessary parsing of OSGi bundles.

Author:

Sanjeeb.Sahoo@Sun.COM

Field Summary

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

modules, parent, providers, repositories

Method Summary

protected void	add(com.sun.enterprise.module.Module newModule)
void	addModuleChangeListener(com.sun.enterprise.module.ModuleChangeListener listener, OSGiModuleImpl module)
void	bundleChanged(org.osgi.framework.BundleEvent event)
com.sun.enterprise.module.ModulesRegistry	createChild()
void	detachAll()
com.sun.enterprise.module.Module	find(java.lang.Class clazz)
java.lang.ClassLoader	getModulesClassLoader(java.lang.ClassLoader parent, java.util.Collection<com.sun.enterprise.module.ModuleDefinition> defs) Returns a ClassLoader capable of loading classes from a set of modules identified by their module definition
java.lang.ClassLoader	getModulesClassLoader(java.lang.ClassLoader parent, java.util.Collection<com.sun.enterprise.module.ModuleDefinition> mds, java.net.URL[] urls) Returns a ClassLoader capable of loading classes from a set of modules identified by their module definition and also load new urls.
org.osgi.service.packageadmin.PackageAdmin	getPackageAdmin()
java.lang.ClassLoader	getParentClassLoader() Returns the parent class loader parenting the class loaders created by modules associated with this registry.
protected com.sun.enterprise.module.Module	newModule(com.sun.enterprise.module.ModuleDefinition moduleDef)
void	parseInhabitants(com.sun.enterprise.module.Module module, java.lang.String name, com.sun.hk2.component.InhabitantsParser inhabitantsParser)
void	register(com.sun.enterprise.module.ModuleLifecycleListener listener)
void	remove(com.sun.enterprise.module.Module module)
boolean	removeModuleChangeListener(com.sun.enterprise.module.ModuleChangeListener listener)
void	setParentClassLoader(java.lang.ClassLoader parent) Sets the classloader parenting the class loaders created by the modules associated with this registry.
void	shutdown()
void	unregister(com.sun.enterprise.module.ModuleLifecycleListener listener)

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

add, add, addRepository, addRepository, changed, createHabitat, createHabitat, createHabitat, createInhabitantsParser, dumpState, getModules, getModules, getModulesProvider, getProvidersClass, getProvidingModule, getRepository, getRunningServices, initializeHabitat, loadFromRepository, makeModuleFor, makeModuleFor, makeModuleFor, newHabitat, populateConfig, print, registerRunningService, removeRepository, unregisterRunningService

Methods inherited from class java.lang.Object

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

Method Detail

bundleChanged

public void bundleChanged(org.osgi.framework.BundleEvent event)

Specified by:

bundleChanged in interface org.osgi.framework.BundleListener

add

protected void add(com.sun.enterprise.module.Module newModule)

Overrides:

add in class com.sun.enterprise.module.common_impl.AbstractModulesRegistryImpl

remove

public void remove(com.sun.enterprise.module.Module module)

Overrides:

remove in class com.sun.enterprise.module.common_impl.AbstractModulesRegistryImpl

newModule

protected com.sun.enterprise.module.Module newModule(com.sun.enterprise.module.ModuleDefinition moduleDef)

Specified by:

newModule in class com.sun.enterprise.module.common_impl.AbstractModulesRegistryImpl

parseInhabitants

public void parseInhabitants(com.sun.enterprise.module.Module module,
                             java.lang.String name,
                             com.sun.hk2.component.InhabitantsParser inhabitantsParser)
                      throws java.io.IOException

Specified by:

parseInhabitants in class com.sun.enterprise.module.common_impl.AbstractModulesRegistryImpl

Throws:

java.io.IOException

createChild

public com.sun.enterprise.module.ModulesRegistry createChild()

Specified by:

createChild in interface com.sun.enterprise.module.ModulesRegistry

detachAll

public void detachAll()

Specified by:

detachAll in interface com.sun.enterprise.module.ModulesRegistry

shutdown

public void shutdown()

Specified by:

shutdown in interface com.sun.enterprise.module.ModulesRegistry

setParentClassLoader

public void setParentClassLoader(java.lang.ClassLoader parent)

Sets the classloader parenting the class loaders created by the modules associated with this registry.

Specified by:

setParentClassLoader in interface com.sun.enterprise.module.ModulesRegistry

Parameters:

parent - parent class loader

getParentClassLoader

public java.lang.ClassLoader getParentClassLoader()

Returns the parent class loader parenting the class loaders created by modules associated with this registry.

Specified by:

getParentClassLoader in interface com.sun.enterprise.module.ModulesRegistry

Returns:

the parent classloader

getModulesClassLoader

public java.lang.ClassLoader getModulesClassLoader(java.lang.ClassLoader parent,
                                                   java.util.Collection<com.sun.enterprise.module.ModuleDefinition> mds,
                                                   java.net.URL[] urls)
                                            throws com.sun.enterprise.module.ResolveError

Returns a ClassLoader capable of loading classes from a set of modules identified by their module definition and also load new urls.

Specified by:

getModulesClassLoader in interface com.sun.enterprise.module.ModulesRegistry

Parameters:

parent - the parent class loader for the returned class loader instance

mds - module definitions for all modules this classloader should be capable of loading

urls - urls to be added to the module classloader

Returns:

class loader instance

Throws:

com.sun.enterprise.module.ResolveError - if one of the provided module definition cannot be resolved

getModulesClassLoader

public java.lang.ClassLoader getModulesClassLoader(java.lang.ClassLoader parent,
                                                   java.util.Collection<com.sun.enterprise.module.ModuleDefinition> defs)
                                            throws com.sun.enterprise.module.ResolveError

Returns a ClassLoader capable of loading classes from a set of modules identified by their module definition

Specified by:

getModulesClassLoader in interface com.sun.enterprise.module.ModulesRegistry

Parameters:

parent - the parent class loader for the returned class loader instance

defs - module definitions for all modules this classloader should be capable of loading classes from

Returns:

class loader instance

Throws:

com.sun.enterprise.module.ResolveError - if one of the provided module definition cannot be resolved

find

public com.sun.enterprise.module.Module find(java.lang.Class clazz)

Specified by:

find in interface com.sun.enterprise.module.ModulesRegistry

getPackageAdmin

public org.osgi.service.packageadmin.PackageAdmin getPackageAdmin()

addModuleChangeListener

public void addModuleChangeListener(com.sun.enterprise.module.ModuleChangeListener listener,
                                    OSGiModuleImpl module)

removeModuleChangeListener

public boolean removeModuleChangeListener(com.sun.enterprise.module.ModuleChangeListener listener)

register

public void register(com.sun.enterprise.module.ModuleLifecycleListener listener)

Specified by:

register in interface com.sun.enterprise.module.ModulesRegistry

unregister

public void unregister(com.sun.enterprise.module.ModuleLifecycleListener listener)

Specified by:

unregister in interface com.sun.enterprise.module.ModulesRegistry