org.codehaus.plexus

Class DefaultPlexusContainer

public class DefaultPlexusContainer extends AbstractLogEnabled implements PlexusContainer

UNKNOWN: clarify configuration handling vis-a-vis user vs default values use classworlds whole hog, plexus' concern is applications. allow setting of a live configuraton so applications that embed plexus can use whatever configuration mechanism they like. They just have to adapt it into something plexus can understand.

Field Summary
static String	BOOTSTRAP_CONFIGURATION
Map	childContainers
ClassWorld	classWorld
ComponentComposerManager	componentComposerManager
ComponentDiscovererManager	componentDiscovererManager
ComponentFactoryManager	componentFactoryManager
ComponentManagerManager	componentManagerManager
ComponentRepository	componentRepository
protected PlexusConfiguration	configuration
Reader	configurationReader
DefaultContext	context
ClassRealm	coreRealm
Date	creationDate
boolean	initialized
LifecycleHandlerManager	lifecycleHandlerManager
LoggerManager	loggerManager
String	name
PlexusContainer	parentContainer
ClassRealm	plexusRealm
boolean	started

Constructor Summary
	DefaultPlexusContainer()

Method Summary
void	addComponentDescriptor(ComponentDescriptor componentDescriptor)
void	addContextValue(Object key, Object value)
void	addJarRepository(File repository)
void	addJarResource(File jar)
void	composeComponent(Object component, ComponentDescriptor componentDescriptor)
PlexusContainer	createChildContainer(String name, List classpathJars, Map context)
PlexusContainer	createChildContainer(String name, List classpathJars, Map context, List discoveryListeners)
Object	createComponentInstance(ComponentDescriptor componentDescriptor)
ComponentManager	createComponentManager(ComponentDescriptor descriptor)
List	discoverComponents(ClassRealm classRealm) TODO: Enhance the ComponentRepository so that it can take entire ComponentSetDescriptors instead of just ComponentDescriptors.
void	dispose()
protected void	disposeAllComponents()
PlexusContainer	getChildContainer(String name)
ClassWorld	getClassWorld()
ComponentDescriptor	getComponentDescriptor(String componentKey)
List	getComponentDescriptorList(String role)
Map	getComponentDescriptorMap(String role)
ClassRealm	getComponentRealm(String id)
ClassRealm	getContainerRealm()
Context	getContext()
ClassRealm	getCoreRealm()
Date	getCreationDate()
protected Reader	getInterpolationConfigurationReader(Reader reader)
Logger	getLogger()
LoggerManager	getLoggerManager()
String	getName()
boolean	hasChildContainer(String name)
boolean	hasComponent(String componentKey)
boolean	hasComponent(String role, String roleHint)
void	initialize()
void	initializeClassWorlds()
protected void	initializeConfiguration()
void	initializeContext()
void	initializeCoreComponents()
void	initializeLoggerManager()
protected void	initializeName() Create a name for our application if one doesn't exist.
void	initializeResources()
void	initializeSystemProperties()
boolean	isInitialized()
boolean	isStarted()
protected void	loadComponentsOnStart()
Object	lookup(String componentKey)
Object	lookup(String role, String roleHint)
List	lookupList(String role)
Map	lookupMap(String role)
void	processConfigurationsDirectory() Process any additional component configuration files that have been specified.
void	processCoreComponentConfiguration(String role, BasicComponentConfigurator configurator, PlexusConfiguration c)
void	registerComponentDiscoveryListener(ComponentDiscoveryListener listener)
void	registerComponentDiscoveryListeners()
void	release(Object component)
void	releaseAll(Map components)
void	releaseAll(List components)
void	removeChildContainer(String name)
void	removeComponentDiscoveryListener(ComponentDiscoveryListener listener)
void	resume(Object component)
void	setClassWorld(ClassWorld classWorld)
void	setConfigurationResource(Reader configuration)
void	setCoreRealm(ClassRealm coreRealm)
void	setLoggerManager(LoggerManager loggerManager)
void	setName(String name)
void	setParentPlexusContainer(PlexusContainer parentContainer)
void	start()
void	suspend(Object component)

Field Detail

BOOTSTRAP_CONFIGURATION

public static final String BOOTSTRAP_CONFIGURATION

childContainers

private Map childContainers

classWorld

private ClassWorld classWorld

componentComposerManager

private ComponentComposerManager componentComposerManager

componentDiscovererManager

private ComponentDiscovererManager componentDiscovererManager

componentFactoryManager

private ComponentFactoryManager componentFactoryManager

componentManagerManager

private ComponentManagerManager componentManagerManager

componentRepository

private ComponentRepository componentRepository

configuration

protected PlexusConfiguration configuration

configurationReader

private Reader configurationReader

context

private DefaultContext context

coreRealm

private ClassRealm coreRealm

creationDate

private final Date creationDate

initialized

private boolean initialized

lifecycleHandlerManager

private LifecycleHandlerManager lifecycleHandlerManager

loggerManager

private LoggerManager loggerManager

name

private String name

parentContainer

private PlexusContainer parentContainer

plexusRealm

private ClassRealm plexusRealm

started

private boolean started

Constructor Detail

DefaultPlexusContainer

public DefaultPlexusContainer()

Method Detail

addComponentDescriptor

public void addComponentDescriptor(ComponentDescriptor componentDescriptor)

addContextValue

public void addContextValue(Object key, Object value)

addJarRepository

public void addJarRepository(File repository)

addJarResource

public void addJarResource(File jar)

composeComponent

public void composeComponent(Object component, ComponentDescriptor componentDescriptor)

createChildContainer

public PlexusContainer createChildContainer(String name, List classpathJars, Map context)

createChildContainer

public PlexusContainer createChildContainer(String name, List classpathJars, Map context, List discoveryListeners)

createComponentInstance

public Object createComponentInstance(ComponentDescriptor componentDescriptor)

createComponentManager

private ComponentManager createComponentManager(ComponentDescriptor descriptor)

discoverComponents

public List discoverComponents(ClassRealm classRealm)

TODO: Enhance the ComponentRepository so that it can take entire ComponentSetDescriptors instead of just ComponentDescriptors.

dispose

public void dispose()

disposeAllComponents

protected void disposeAllComponents()

getChildContainer

public PlexusContainer getChildContainer(String name)

getClassWorld

public ClassWorld getClassWorld()

getComponentDescriptor

public ComponentDescriptor getComponentDescriptor(String componentKey)

getComponentDescriptorList

public List getComponentDescriptorList(String role)

getComponentDescriptorMap

public Map getComponentDescriptorMap(String role)

getComponentRealm

public ClassRealm getComponentRealm(String id)

Deprecated: Use getContainerRealm() instead.

getContainerRealm

public ClassRealm getContainerRealm()

getContext

public Context getContext()

getCoreRealm

public ClassRealm getCoreRealm()

getCreationDate

public Date getCreationDate()

getInterpolationConfigurationReader

protected Reader getInterpolationConfigurationReader(Reader reader)

getLogger

public Logger getLogger()

getLoggerManager

public LoggerManager getLoggerManager()

getName

public String getName()

hasChildContainer

public boolean hasChildContainer(String name)

hasComponent

public boolean hasComponent(String componentKey)

hasComponent

public boolean hasComponent(String role, String roleHint)

initialize

public void initialize()

initializeClassWorlds

private void initializeClassWorlds()

initializeConfiguration

protected void initializeConfiguration()

initializeContext

private void initializeContext()

initializeCoreComponents

private void initializeCoreComponents()

initializeLoggerManager

private void initializeLoggerManager()

initializeName

protected void initializeName()

Create a name for our application if one doesn't exist.

initializeResources

public void initializeResources()

initializeSystemProperties

private void initializeSystemProperties()

isInitialized

public boolean isInitialized()

isStarted

public boolean isStarted()

loadComponentsOnStart

protected void loadComponentsOnStart()

lookup

public Object lookup(String componentKey)

lookup

public Object lookup(String role, String roleHint)

lookupList

public List lookupList(String role)

UNKNOWN: Change this to include components looked up from parents as well...

lookupMap

public Map lookupMap(String role)

UNKNOWN: Change this to include components looked up from parents as well...

processConfigurationsDirectory

private void processConfigurationsDirectory()

Process any additional component configuration files that have been specified. The specified directory is scanned recursively so configurations can be within nested directories to help with component organization.