The Carbon Java Framework  

The Carbon Classloader-based Config Module

Config-Classloader Service Usage

Printer Friendly Version

Author: Jordan Reed (jreed at
Version: $Revision: 1.1 $($Author: jdreed $ / $Date: 2004/01/26 22:09:59 $)
Created: January 2004


This service is not used directly by client code. Once configured, it plugs into Carbon's configuration subsystem and is used behind the scenes. The purpose of this document is to describe the configuration.

This service has two distinct possible usages. I can be used to load configuration branches out of a local classpath, such as inside a jar or ear. It may also be used with URL prefixes that allow an application to leverage Java's URLClassloader capabilities and place configuration branches inside of HTTP servers.

Classpath Configuration

In order to access configurations stored in the classpath, a link must be created in the configuration hierachy. The link configuration needs to be of type Within a ClassloaderLinkNodeConfiguration. To place the entire configuration structure into the classpath use the document and instance of ClassloaderLinkNodeConfiguration.

Property Name Description Required (Y/N)
PathPrefix This is the prefix path to locate the resources inside of a classpath. For example, if a jar file contained the configuration resources inside of a "config" directory, this would be set to config. When a call is made to load a resrouce, this prefix is prepended. Y
ClassloaderURLs URLs where configuration information is stored. This may be valid file url (file://) or a remote URL (http://). N

Example of a Local Classpath Link Configuration



The above example stores the config inside of a local classpath. For example, inside of an EAR file, there may be a CarbonConfig.jar, which contains a "config" directory that holds configuration.

Example of a URL Classpath Link Configuration



The above example stores the config inside an http server with documents residing under http://localhost:8080/application-config.

Best Practices - Fully Contained Application

The module may be used to store configuration inside of a local classpath. This is most appropriate when deploying an application as a completely self-contained JAR, EAR or WAR file.

When deploying a self-contained Enterprise Archive (EAR) it is recommended that Carbon configuration be stored inside of config directory in its own JAR file inside the EAR. The Class-path: property in the various manifests inside the EAR should contain a reference to the configuration jar. At the root of the configuration JAR one should place a document using the ClassloaderLinkNodeConfiguration and giving the config directory as the PathPrefix property.

When deploying a self-contained Web Archive (WAR) one may follow the JAR option mentioned in the previous paragraph and place it into the WEB-INF/lib directory of the WAR. Alternate one may leave the configuration exanded in the WEB-INF/classes directory. Both options are valid.

Best Practices - URL Classpath

Storing configuration inside a URL classpath is straight-forward. The primary use is to have a centralized configuration shared by all nodes of an application (such as a cluster of machines). The server should be behind the DMZ on the network preventing outside systems from viewing the config repository.

Copyright © 2001-2003, Sapient Corporation