/**
*
* Copyright 2003-2004 The Apache Software Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.geronimo.kernel.config;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.EOFException;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URL;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Set;
import javax.management.MalformedObjectNameException;
import javax.management.ObjectName;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.geronimo.gbean.GAttributeInfo;
import org.apache.geronimo.gbean.GBeanData;
import org.apache.geronimo.gbean.GBeanInfo;
import org.apache.geronimo.gbean.GBeanInfoBuilder;
import org.apache.geronimo.gbean.GBeanLifecycle;
import org.apache.geronimo.kernel.GBeanAlreadyExistsException;
import org.apache.geronimo.kernel.GBeanNotFoundException;
import org.apache.geronimo.kernel.Kernel;
import org.apache.geronimo.kernel.ObjectInputStreamExt;
import org.apache.geronimo.kernel.DependencyManager;
import org.apache.geronimo.kernel.jmx.JMXUtil;
import org.apache.geronimo.kernel.management.State;
import org.apache.geronimo.kernel.repository.MissingDependencyException;
import org.apache.geronimo.kernel.repository.Repository;
/**
* A Configuration represents a collection of runnable services that can be
* loaded into a Geronimo Kernel and brought online. The primary components in
* a Configuration are a codebase, represented by a collection of URLs that
* is used to locate classes, and a collection of GBean instances that define
* its state.
* <p/>
* The persistent attributes of the Configuration are:
* <ul>
* <li>its unique configId used to identify this specific config</li>
* <li>the configId of a parent Configuration on which this one is dependent</li>
* <li>a List<URI> of code locations (which may be absolute or relative to a baseURL)</li>
* <li>a byte[] holding the state of the GBeans instances in Serialized form</li>
* </ul>
* When a configuration is started, it converts the URIs into a set of absolute
* URLs by resolving them against the specified baseURL (this would typically
* be the root of the CAR file which contains the configuration) and then
* constructs a ClassLoader for that codebase. That ClassLoader is then used
* to de-serialize the persisted GBeans, ensuring the GBeans can be recycled
* as necessary. Once the GBeans have been restored, they are brought online
* by registering them with the MBeanServer.
* <p/>
* A dependency on the Configuration is created for every GBean it loads. As a
* result, a startRecursive() operation on the configuration will result in
* a startRecursive() for all the GBeans it contains. Similarly, if the
* Configuration is stopped then all of its GBeans will be stopped as well.
*
* @version $Rev: 280084 $ $Date: 2005-09-11 00:35:53 -0600 (Sun, 11 Sep 2005) $
*/
public class Configuration implements GBeanLifecycle, ConfigurationParent {
private static final Log log = LogFactory.getLog(Configuration.class);
public static ObjectName getConfigurationObjectName(URI configId) throws MalformedObjectNameException {
return new ObjectName("geronimo.config:name=" + ObjectName.quote(configId.toString()));
}
public static boolean isConfigurationObjectName(ObjectName name) {
return name.getDomain().equals("geronimo.config") && name.getKeyPropertyList().size() == 1 && name.getKeyProperty("name") != null;
}
/**
* The kernel in which this configuration is registered
*/
private final Kernel kernel;
/**
* The registered objectName for this configuraion
*/
private final String objectNameString;
private final ObjectName objectName;
/**
* URI used to referr to this configuration in the configuration manager
*/
private final URI id;
/**
* Identifies the type of configuration (WAR, RAR et cetera)
*/
private final ConfigurationModuleType moduleType;
/**
* The uri of the parent of this configuration. May be null.
*/
private final URI[] parentId;
/**
* The configuration store from which this configuration was loaded. May be null if this configuration
* was not loaded from a store. The store is notified when the configurations stopps so it can update
* the saved state of the configration.
*/
private final ConfigurationStore configurationStore;
/**
* Used to override stored attribute values with values set by the user.
*/
private final ManageableAttributeStore manageableStore;
private final List dependencies;
private final List classPath;
private final String domain;
private final String server;
/**
* The names of all GBeans contained in this configuration.
*/
private Set objectNames;
/**
* The classloader used to load the child GBeans contained in this configuration.
*/
private MultiParentClassLoader configurationClassLoader;
/**
* The GBeanData for the GBeans contained in this configuration. These must be persisted as a ByteArray, becuase
* the data can only be deserialized in the configurationClassLoader, which is not available until this Configuration
* is deserialized and started.
*/
private byte[] gbeanState;
/**
* Base path used to resolve relative class path entries.
*/
private final URL baseURL;
/**
* The repositories used dependencies.
*/
private final Collection repositories;
/**
* Only used to allow declaration as a reference.
*/
public Configuration() {
kernel = null;
objectNameString = null;
objectName = null;
id = null;
moduleType = null;
parentId = null;
configurationStore = null;
domain = null;
server = null;
objectNames = null;
configurationClassLoader = null;
dependencies = null;
classPath = null;
baseURL = null;
repositories = null;
manageableStore = null;
}
/**
* Constructor that can be used to create an offline Configuration, typically
* only used publically during the deployment process for initial configuration.
*
* @param id the unique id of this Configuration
* @param moduleType the module type identifier
* @param classPath a List<URI> of locations that define the codebase for this Configuration
* @param gbeanState a byte array contain the Java Serialized form of the GBeans in this Configuration
* @param repositories a Collection<Repository> of repositories used to resolve dependencies
* @param dependencies a List<URI> of dependencies
*/
public Configuration(Kernel kernel,
String objectName,
URI id,
ConfigurationModuleType moduleType,
URL baseURL,
URI[] parentId,
String domain,
String server,
List classPath,
byte[] gbeanState,
Collection repositories,
List dependencies,
ConfigurationStore configurationStore,
ManageableAttributeStore manageableStore) throws Exception {
this.kernel = kernel;
this.objectNameString = objectName;
this.objectName = JMXUtil.getObjectName(objectName);
this.id = id;
this.moduleType = moduleType;
this.baseURL = baseURL;
this.parentId = parentId;
this.gbeanState = gbeanState;
this.repositories = repositories;
if (classPath != null) {
this.classPath = classPath;
} else {
this.classPath = Collections.EMPTY_LIST;
}
if (dependencies != null) {
this.dependencies = dependencies;
} else {
this.dependencies = Collections.EMPTY_LIST;
}
this.configurationStore = configurationStore;
this.manageableStore = manageableStore;
this.domain = domain;
this.server = server;
addParentDependencies(kernel, id, parentId);
}
public String getObjectName() {
return objectNameString;
}
public String getDomain() {
return domain;
}
public String getServer() {
return server;
}
public void doStart() throws Exception {
// build configurationClassLoader
URL[] urls = resolveClassPath(classPath, baseURL, dependencies, repositories);
log.debug("ClassPath for " + id + " resolved to " + Arrays.asList(urls));
if (parentId == null || parentId.length == 0) {
// no explicit parent set, so use the class loader of this class as
// the parent... this class should be in the root geronimo classloader,
// which is normally the system class loader but not always, so be safe
configurationClassLoader = new MultiParentClassLoader(id, urls, getClass().getClassLoader());
} else {
configurationClassLoader = new MultiParentClassLoader(id, urls, getClassLoaders(parentId));
}
// DSS: why exactally are we doing this? I bet there is a reason, but
// we should state why here.
ClassLoader oldCl = Thread.currentThread().getContextClassLoader();
try {
Thread.currentThread().setContextClassLoader(configurationClassLoader);
// create and initialize GBeans
Collection gbeans = loadGBeans(gbeanState, configurationClassLoader);
// register all the GBeans
Set objectNames = new HashSet();
for (Iterator i = gbeans.iterator(); i.hasNext();) {
GBeanData gbeanData = (GBeanData) i.next();
// massage the GBeanData and add the GBean to the kernel
loadGBean(gbeanData, objectNames);
}
this.objectNames = objectNames;
} finally {
Thread.currentThread().setContextClassLoader(oldCl);
}
log.info("Started configuration " + id);
}
private void addParentDependencies(Kernel kernel, URI id, URI[] parentId) throws MalformedObjectNameException {
if (parentId != null && parentId.length > 0) {
ObjectName name = getConfigurationObjectName(id);
Set parentNames = new HashSet();
for (int i = 0; i < parentId.length; i++) {
URI uri = parentId[i];
ObjectName parentName = getConfigurationObjectName(uri);
parentNames.add(parentName);
}
DependencyManager dependencyManager = kernel.getDependencyManager();
dependencyManager.addDependencies(name, parentNames);
}
}
private ClassLoader[] getClassLoaders(URI[] parentId) throws Exception {
ClassLoader[] classLoaders = new ClassLoader[parentId.length];
for (int i = 0; i < parentId.length; i++) {
URI uri = parentId[i];
ObjectName parentName = getConfigurationObjectName(uri);
classLoaders[i] = (ClassLoader) kernel.getAttribute(parentName, "configurationClassLoader");
}
return classLoaders;
}
private static URL[] resolveClassPath(List classPath, URL baseURL, List dependencies, Collection repositories) throws MalformedURLException, MissingDependencyException {
if (classPath == null) {
classPath = Collections.EMPTY_LIST;
}
if (dependencies == null) {
dependencies = Collections.EMPTY_LIST;
}
URL[] urls = new URL[dependencies.size() + classPath.size()];
int idx = 0;
for (Iterator i = dependencies.iterator(); i.hasNext();) {
URI uri = (URI) i.next();
URL url = null;
for (Iterator j = repositories.iterator(); j.hasNext();) {
Repository repository = (Repository) j.next();
if (repository.hasURI(uri)) {
url = repository.getURL(uri);
break;
}
}
if (url == null) {
throw new MissingDependencyException("Unable to resolve dependency " + uri);
}
urls[idx++] = url;
}
for (Iterator i = classPath.iterator(); i.hasNext();) {
URI uri = (URI) i.next();
urls[idx++] = new URL(baseURL, uri.toString());
}
assert idx == urls.length;
return urls;
}
private static void setGBeanBaseUrl(GBeanData gbeanData, URL baseUrl) {
GBeanInfo gbeanInfo = gbeanData.getGBeanInfo();
Set attributes = gbeanInfo.getAttributes();
for (Iterator iterator = attributes.iterator(); iterator.hasNext();) {
GAttributeInfo attribute = (GAttributeInfo) iterator.next();
if (attribute.getName().equals("configurationBaseUrl") && attribute.getType().equals("java.net.URL")) {
gbeanData.setAttribute("configurationBaseUrl", baseUrl);
return;
}
}
}
public synchronized void doStop() throws Exception {
log.info("Stopping configuration " + id);
// shutdown the configuration and unload all beans
shutdown();
}
private void shutdown() {
// unregister all GBeans
if (objectNames != null) {
for (Iterator i = objectNames.iterator(); i.hasNext();) {
ObjectName name = (ObjectName) i.next();
kernel.getDependencyManager().removeDependency(name, objectName);
try {
log.trace("Unregistering GBean " + name);
kernel.unloadGBean(name);
} catch (Exception e) {
// ignore
log.warn("Could not unregister child " + name, e);
}
}
}
// destroy the class loader
if (configurationClassLoader != null) {
configurationClassLoader.destroy();
configurationClassLoader = null;
}
}
public void doFail() {
shutdown();
}
public synchronized void saveState() throws Exception {
GBeanData[] gbeans = storeCurrentGBeans();
// update the configuration store
if (configurationStore != null) {
ConfigurationData configurationData = new ConfigurationData();
configurationData.setId(id);
configurationData.setModuleType(moduleType);
configurationData.setDomain(domain);
configurationData.setServer(server);
if (parentId != null && parentId.length > 0) {
configurationData.setParentId(Arrays.asList(parentId));
} else {
configurationData.setParentId(Collections.EMPTY_LIST);
}
configurationData.setGBeans(Arrays.asList(gbeans));
configurationData.setDependencies(dependencies);
configurationData.setClassPath(classPath);
configurationStore.updateConfiguration(configurationData);
}
}
/**
* Return the unique id of this Configuration's parent
*
* @return the unique id of the parent, or null if it does not have one
*/
public URI[] getParentId() {
return parentId;
}
/**
* Return the unique Id
*
* @return the unique Id
*/
public URI getId() {
return id;
}
/**
* Gets the type of the configuration (WAR, RAR et cetera)
*
* @return Type of the configuration.
*/
public ConfigurationModuleType getModuleType() {
return moduleType;
}
public byte[] getGBeanState() {
return gbeanState;
}
public ClassLoader getConfigurationClassLoader() {
return configurationClassLoader;
}
public synchronized void addGBean(GBeanData beanData, boolean start) throws InvalidConfigException, GBeanAlreadyExistsException {
ClassLoader oldCl = Thread.currentThread().getContextClassLoader();
try {
Thread.currentThread().setContextClassLoader(configurationClassLoader);
ObjectName name = loadGBean(beanData, objectNames);
if(start) {
try {
kernel.startRecursiveGBean(name);
} catch (GBeanNotFoundException e) {
throw new IllegalStateException("How could we not find a GBean that we just loaded ('"+name+"')?");
}
}
} finally {
Thread.currentThread().setContextClassLoader(oldCl);
}
storeCurrentGBeans();
}
public synchronized void removeGBean(ObjectName name) throws GBeanNotFoundException {
if(!objectNames.contains(name)) {
throw new GBeanNotFoundException(name);
}
kernel.getDependencyManager().removeDependency(name, this.objectName);
try {
if(kernel.getGBeanState(name) == State.RUNNING_INDEX) {
kernel.stopGBean(name);
}
kernel.unloadGBean(name);
} catch (GBeanNotFoundException e) {
// Bean is no longer loaded
}
objectNames.remove(name);
}
private ObjectName loadGBean(GBeanData beanData, Set objectNames) throws GBeanAlreadyExistsException {
// todo jnb: initializing attibutes here seems questionable - perhaps these should be injected
// by the ConfigurationManager once the Configuration has been loaded
ObjectName name = beanData.getName();
setGBeanBaseUrl(beanData, baseURL);
setManageableAttributes(beanData);
log.trace("Registering GBean " + name);
kernel.loadGBean(beanData, configurationClassLoader);
objectNames.add(name);
// todo change this to a dependency on the gbeanData itself as soon as we add that feature
kernel.getDependencyManager().addDependency(name, this.objectName);
return name;
}
private void setManageableAttributes(GBeanData data) {
if(manageableStore == null) {
log.debug("Configuration cannot load manageable attributes; no manageable store present");
return;
}
List list = data.getGBeanInfo().getManageableAttributes();
for (int i = 0; i < list.size(); i++) {
GAttributeInfo info = (GAttributeInfo) list.get(i);
Object value = manageableStore.getValue(id.toString(), data.getName(), info);
if(value != null) {
data.setAttribute(info.getName(), value);
}
}
}
/**
* Load GBeans from the supplied byte array using the supplied ClassLoader
*
* @param gbeanState the serialized form of the GBeans
* @param cl the ClassLoader used to locate classes needed during deserialization
* @return a Map<ObjectName, GBeanMBean> of GBeans loaded from the persisted state
* @throws InvalidConfigException if there is a problem deserializing the state
*/
private static Collection loadGBeans(byte[] gbeanState, ClassLoader cl) throws InvalidConfigException {
Map gbeans = new HashMap();
try {
ObjectInputStream ois = new ObjectInputStreamExt(new ByteArrayInputStream(gbeanState), cl);
try {
while (true) {
GBeanData gbeanData = new GBeanData();
gbeanData.readExternal(ois);
gbeans.put(gbeanData.getName(), gbeanData);
}
} catch (EOFException e) {
// ok
} finally {
ois.close();
}
// avoid duplicate object names
return gbeans.values();
} catch (Exception e) {
throw new InvalidConfigException("Unable to deserialize GBeanState", e);
}
}
/**
* Return a byte array containing the persisted form of the supplied GBeans
*
* @return the persisted GBeans
* @throws org.apache.geronimo.kernel.config.InvalidConfigException if there is a problem serializing the state
*/
public synchronized GBeanData[] storeCurrentGBeans() throws InvalidConfigException {
// get the gbean data for all gbeans
GBeanData[] gbeans = new GBeanData[objectNames.size()];
Iterator iterator = objectNames.iterator();
for (int i = 0; i < gbeans.length; i++) {
ObjectName objectName = (ObjectName) iterator.next();
try {
gbeans[i] = kernel.getGBeanData(objectName);
} catch (Exception e) {
throw new InvalidConfigException("Unable to serialize GBeanData for " + objectName, e);
}
}
// save state
try {
gbeanState = storeGBeans(gbeans);
} catch (InvalidConfigException e) {
log.info("Unable to update persistent state during shutdown", e);
}
return gbeans;
}
/**
* Return a byte array containing the persisted form of the supplied GBeans
*
* @param gbeans the gbean data to persist
* @return the persisted GBeans
* @throws org.apache.geronimo.kernel.config.InvalidConfigException if there is a problem serializing the state
*/
public static byte[] storeGBeans(GBeanData[] gbeans) throws InvalidConfigException {
return storeGBeans(Arrays.asList(gbeans));
}
public static byte[] storeGBeans(List gbeans) throws InvalidConfigException {
ByteArrayOutputStream baos = new ByteArrayOutputStream();
ObjectOutputStream oos;
try {
oos = new ObjectOutputStream(baos);
} catch (IOException e) {
throw (AssertionError) new AssertionError("Unable to initialize ObjectOutputStream").initCause(e);
}
for (Iterator iterator = gbeans.iterator(); iterator.hasNext();) {
GBeanData gbeanData = (GBeanData) iterator.next();
try {
gbeanData.writeExternal(oos);
} catch (Exception e) {
throw new InvalidConfigException("Unable to serialize GBeanData for " + gbeanData.getName(), e);
}
}
try {
oos.flush();
} catch (IOException e) {
throw (AssertionError) new AssertionError("Unable to flush ObjectOutputStream").initCause(e);
}
return baos.toByteArray();
}
public static final GBeanInfo GBEAN_INFO;
static {
GBeanInfoBuilder infoFactory = new GBeanInfoBuilder(Configuration.class);//does not use jsr-77 naming
infoFactory.addAttribute("kernel", Kernel.class, false);
infoFactory.addAttribute("objectName", String.class, false);
infoFactory.addAttribute("id", URI.class, true, false);
infoFactory.addAttribute("type", ConfigurationModuleType.class, true, false);
infoFactory.addAttribute("parentId", URI[].class, true, false);
infoFactory.addAttribute("domain", String.class, true, false);
infoFactory.addAttribute("server", String.class, true, false);
infoFactory.addAttribute("classPath", List.class, true, false);
infoFactory.addAttribute("dependencies", List.class, true, false);
infoFactory.addAttribute("gBeanState", byte[].class, true, false);
infoFactory.addAttribute("baseURL", URL.class, true, false);
infoFactory.addAttribute("configurationClassLoader", ClassLoader.class, false);
infoFactory.addReference("Repositories", Repository.class, "GBean");
infoFactory.addReference("ConfigurationStore", ConfigurationStore.class);
infoFactory.addReference("AttributeStore", ManageableAttributeStore.class);
infoFactory.addOperation("addGBean", new Class[]{GBeanData.class, boolean.class});
infoFactory.addOperation("removeGBean", new Class[]{ObjectName.class});
infoFactory.addOperation("saveState");
infoFactory.setConstructor(new String[]{
"kernel",
"objectName",
"id",
"type",
"baseURL",
"parentId",
"domain",
"server",
"classPath",
"gBeanState",
"Repositories",
"dependencies",
"ConfigurationStore",
"AttributeStore"});
GBEAN_INFO = infoFactory.getBeanInfo();
}
public static GBeanInfo getGBeanInfo() {
return GBEAN_INFO;
}
}