01: /**
02: * Licensed to the Apache Software Foundation (ASF) under one or more
03: * contributor license agreements. See the NOTICE file distributed with
04: * this work for additional information regarding copyright ownership.
05: * The ASF licenses this file to You under the Apache License, Version 2.0
06: * (the "License"); you may not use this file except in compliance with
07: * the License. You may obtain a copy of the License at
08: *
09: * http://www.apache.org/licenses/LICENSE-2.0
10: *
11: * Unless required by applicable law or agreed to in writing, software
12: * distributed under the License is distributed on an "AS IS" BASIS,
13: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14: * See the License for the specific language governing permissions and
15: * limitations under the License.
16: */package org.apache.geronimo.kernel.config;
17:
18: import org.apache.geronimo.gbean.AbstractName;
19: import org.apache.geronimo.gbean.GBeanData;
20: import org.apache.geronimo.kernel.GBeanNotFoundException;
21: import org.apache.geronimo.kernel.repository.Artifact;
22:
23: /**
24: * A specialized ConfigurationManager that can change the set of GBeans
25: * included in the configuration at runtime.
26: *
27: * @version $Rev: 476049 $ $Date: 2006-11-16 20:35:17 -0800 (Thu, 16 Nov 2006) $
28: */
29: public interface EditableConfigurationManager extends
30: ConfigurationManager {
31: /**
32: * Adds a new GBean to an existing Configuration.
33: * @param configID The configuration to add the GBean to.
34: * @param gbean The data representing the GBean to add.
35: * @param start If true, the GBean should be started as part of this call.
36: */
37: void addGBeanToConfiguration(Artifact configID, GBeanData gbean,
38: boolean start) throws InvalidConfigException;
39:
40: /**
41: * Adds a new GBean to an existing Configuration.
42: * @param configID The configuration to add the GBean to.
43: * @param name The short name for the new GBean.
44: * @param gbean The data representing the GBean to add. This must not have an abstract name set.
45: * @param start If true, the GBean should be started as part of this call.
46: */
47: void addGBeanToConfiguration(Artifact configID, String name,
48: GBeanData gbean, boolean start)
49: throws InvalidConfigException;
50:
51: /**
52: * Removes a GBean from a configuration. Note: this may simply mark it to
53: * not be loaded in the future, as opposed to actually removing it from
54: * the data in the config store.
55: * @param configID The configuration to remove the GBean from.
56: * @param gbean The ObjectName of the GBean to remove.
57: */
58: void removeGBeanFromConfiguration(Artifact configID,
59: AbstractName gbean) throws InvalidConfigException,
60: GBeanNotFoundException;
61: }
|