org.apache.geronimo.kernel.config
Interface EditableConfigurationManager

All Superinterfaces:

ConfigurationManager

All Known Implementing Classes:

EditableKernelConfigurationManager

public interface EditableConfigurationManager
extends ConfigurationManager

A specialized ConfigurationManager that can change the set of GBeans included in the configuration at runtime.

Method Summary

void	addGBeanToConfiguration(Artifact configID, GBeanData gbean, boolean start) Adds a new GBean to an existing Configuration.
void	addGBeanToConfiguration(Artifact configID, String name, GBeanData gbean, boolean start) Adds a new GBean to an existing Configuration.
void	removeGBeanFromConfiguration(Artifact configID, AbstractName gbean) Removes a GBean from a configuration.

Methods inherited from interface org.apache.geronimo.kernel.config.ConfigurationManager

getArtifactResolver, getConfiguration, getInstalled, getLoaded, getRepositories, getRunning, getStoreForConfiguration, getStores, isConfiguration, isInstalled, isLoaded, isOnline, isRunning, listConfigurations, listConfigurations, listStores, loadConfiguration, loadConfiguration, loadConfiguration, loadConfiguration, reloadConfiguration, reloadConfiguration, reloadConfiguration, reloadConfiguration, reloadConfiguration, reloadConfiguration, restartConfiguration, restartConfiguration, setOnline, sort, startConfiguration, startConfiguration, stopConfiguration, stopConfiguration, uninstallConfiguration, unloadConfiguration, unloadConfiguration

Method Detail

addGBeanToConfiguration

void addGBeanToConfiguration(Artifact configID,
                             GBeanData gbean,
                             boolean start)
                             throws InvalidConfigException

Adds a new GBean to an existing Configuration.

Parameters:

configID - The configuration to add the GBean to.

gbean - The data representing the GBean to add.

start - If true, the GBean should be started as part of this call.

Throws:

InvalidConfigException

addGBeanToConfiguration

void addGBeanToConfiguration(Artifact configID,
                             String name,
                             GBeanData gbean,
                             boolean start)
                             throws InvalidConfigException

Adds a new GBean to an existing Configuration.

Parameters:

configID - The configuration to add the GBean to.

name - The short name for the new GBean.

gbean - The data representing the GBean to add. This must not have an abstract name set.

start - If true, the GBean should be started as part of this call.

Throws:

InvalidConfigException

removeGBeanFromConfiguration

void removeGBeanFromConfiguration(Artifact configID,
                                  AbstractName gbean)
                                  throws InvalidConfigException,
                                         GBeanNotFoundException

Removes a GBean from a configuration. Note: this may simply mark it to not be loaded in the future, as opposed to actually removing it from the data in the config store.

Parameters:

configID - The configuration to remove the GBean from.

gbean - The ObjectName of the GBean to remove.

Throws:

InvalidConfigException

GBeanNotFoundException