com.jcorporate.expresso.kernel.management
Class ExpressoRuntimeMap

java.lang.Object
  com.jcorporate.expresso.kernel.management.ExpressoRuntimeMap

public final class ExpressoRuntimeMap

extends Object

This class allows controllers and other classes to potentially access Expresso Runtime Environments that they aren't necessarily a part of. This is critical for Management tools, which, by nature are outside of the Expresso container hierarchy.

Version:

$Revision: 1.5 $ on $Date: 2004/11/17 20:48:17 $

Author:

Michael Rimov

Constructor Summary

ExpressoRuntimeMap()
Default constructor

Method Summary

static RootContainerInterface	getDefaultRuntime() Retrieve the default runtime.
static RootContainerInterface	getRuntime(String name) Retrieve a runtime environment as specified by the name parameter.
static void	registerRuntime(String name, RootContainerInterface expressoRuntime) Add this runtime to the system
static void	unregisterRuntime(String name) Unregister a runtime, this occurs when the runtime is being destroyed, either via a context reload or by a the container shutting down.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExpressoRuntimeMap

public ExpressoRuntimeMap()

Default constructor

Method Detail

registerRuntime

public static void registerRuntime(String name,
                                   RootContainerInterface expressoRuntime)

Add this runtime to the system

Parameters:

name - Name of the runtime. If blank, it is automatically considered the default runtime. If it is the first runtime to be entered, it is also set as the default runtime until something else takes it place.

expressoRuntime - The Root Container of a particular runtime environment.

getRuntime

public static RootContainerInterface getRuntime(String name)

Retrieve a runtime environment as specified by the name parameter. If name is null or empty string, it returns the default runtime, if not, then it will return whatever is in the internal Runtime Map;

Parameters:

name - Name of the runtime to retrieve.

Returns:

the Expresso Root Container as specified by name.

getDefaultRuntime

public static RootContainerInterface getDefaultRuntime()

Retrieve the default runtime.

Returns:

a Root Container interface for the default runtime in this JVM

unregisterRuntime

public static void unregisterRuntime(String name)

Unregister a runtime, this occurs when the runtime is being destroyed, either via a context reload or by a the container shutting down.

Parameters:

name - the Name of the context to unregister