commonjava-developer

[<joh...@co...>]

Update of /cvsroot/commonjava/commonjava-projects/commonjava-config
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv26323

Modified Files:
	.project .classpath project.xml project.properties 
Log Message:
updated documentation in project.xml files, and added functionality to:

Console:
- provide convenient way to prompt the user for more information

Config:
- Provide snap-in container stacking, or scoping
- Provide a JBoss service implementation of a snap-in container

Probably other things, but I don't honestly remember everything...

Index: .project
===================================================================
RCS file: /cvsroot/commonjava/commonjava-projects/commonjava-config/.project,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- .project	18 Sep 2003 00:42:46 -0000	1.1
+++ .project	18 Feb 2004 06:11:01 -0000	1.2
@@ -1,19 +1,24 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <projectDescription>
-  <name>commonjava-config</name>
-  <comment>
+	<name>commonjava-config</name>
+	<comment>
   </comment>
-  <projects>
-  </projects>
-  <buildSpec>
-    <buildCommand>
-      <name>org.eclipse.jdt.core.javabuilder</name>
-      <arguments>
-      </arguments>
-    </buildCommand>
-  </buildSpec>
-  <natures>
-    <nature>org.eclipse.jdt.core.javanature</nature>
-  </natures>
-</projectDescription>
\ No newline at end of file
+	<projects>
+		<project>commonjava-codec</project>
+		<project>commonjava-io</project>
+		<project>commonjava-lang</project>
+		<project>commonjava-opl</project>
+		<project>commonjava-reflection</project>
+		<project>commonjava-util</project>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+</projectDescription>

Index: .classpath
===================================================================
RCS file: /cvsroot/commonjava/commonjava-projects/commonjava-config/.classpath,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- .classpath	9 Jan 2004 05:05:14 -0000	1.4
+++ .classpath	18 Feb 2004 06:11:01 -0000	1.5
@@ -2,14 +2,17 @@
 <classpath>
     <classpathentry kind="src" path="src/java"/>
     <classpathentry kind="var" path="JRE_LIB" sourcepath="JRE_SRC"/>
-    <classpathentry kind="var" path="MAVEN_REPO/commonjava/jars/commonjava-lang-2.0.jar"/>
-    <classpathentry kind="var" path="MAVEN_REPO/commonjava/jars/commonjava-codec-2.0.jar"/>
-    <classpathentry kind="var" path="MAVEN_REPO/commonjava/jars/commonjava-io-2.0.jar"/>
-    <classpathentry kind="var"
-        path="MAVEN_REPO/commonjava/jars/commonjava-reflection-2.0.jar" sourcepath="ECLIPSE_HOME/workspace/commonjava-reflection/src/java"/>
     <classpathentry kind="var" path="MAVEN_REPO/commons-logging/jars/commons-logging-1.0.2.jar"/>
-    <classpathentry kind="var"
-        path="MAVEN_REPO/commonjava/jars/commonjava-opl-2.1-4.jar" sourcepath="ECLIPSE_HOME/workspace/commonjava-opl/src/java"/>
-    <classpathentry kind="var" path="MAVEN_REPO/commonjava/jars/commonjava-util-2.0-2.jar"/>
+    <classpathentry kind="var" path="MAVEN_REPO/jboss/jars/jboss-system-3.2.3.jar"/>
+    <classpathentry kind="var" path="MAVEN_REPO/jboss/jars/jnp-client-3.2.3.jar"/>
+    <classpathentry kind="var" path="MAVEN_REPO/jboss/jars/jboss-jmx-3.2.3.jar"/>
+    <classpathentry kind="var" path="MAVEN_REPO/jboss/jars/jboss-common-3.2.3.jar"/>
+    <classpathentry kind="var" path="MAVEN_REPO/jboss/jars/jboss-3.2.3.jar"/>
+    <classpathentry kind="src" path="/commonjava-util"/>
+    <classpathentry kind="src" path="/commonjava-reflection"/>
+    <classpathentry kind="src" path="/commonjava-opl"/>
+    <classpathentry kind="src" path="/commonjava-lang"/>
+    <classpathentry kind="src" path="/commonjava-io"/>
+    <classpathentry kind="src" path="/commonjava-codec"/>
     <classpathentry kind="output" path="target/classes"/>
 </classpath>

Index: project.xml
===================================================================
RCS file: /cvsroot/commonjava/commonjava-projects/commonjava-config/project.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- project.xml	9 Jan 2004 05:05:14 -0000	1.2
+++ project.xml	18 Feb 2004 06:11:01 -0000	1.3
@@ -3,9 +3,9 @@
 <project>
   <pomVersion>3</pomVersion>
   <id>commonjava-config</id>
-  <name>CommonJava Configuration Objects</name>
+  <name>Configurations</name>
   <groupId>commonjava</groupId>
-  <currentVersion>2.1</currentVersion>
+  <currentVersion>2.1-1</currentVersion>
   <organization>
     <name>CommonJava Open Component Project</name>
     <url>http://www.commonjava.org</url>
@@ -13,6 +13,30 @@
   <inceptionYear>2002</inceptionYear>
   <package>org.commonjava.config</package>
   
+  <description>
+    The Configurations project is intended to provide various ways of configuring an application, 
+    beyond mere properties files. These methods are mainly based on XML configuration files, although
+    one notable exception to this is the org.commonjava.config.Configuration class, which can have
+    any number of format/parse codecs for it. XML and properties file format are supported natively.
+    Beyond this, the next generation of configuration involves building and storing complex configuration
+    objects, which can then be referenced by an application via a common configuration repository. These
+    objects are called snap-ins, and are managed by the SnapInContainer/SnapInContainerLoader hierarchy, 
+    in org.commonjava.config.snapin. The snap-in package was originally intended to be coupled with OPL 
+    (another CommonJava project, for parsing XML into objects), but technically can be used with any
+    object parser. The SnapInContainerLoader implementation may drive the parsing process, as in the
+    case of GenericSnapInContainerLoader, but doesn't have to. The only requirement of the snap-in
+    functionality is that it serve as a commonly-accessible repository for configuration objects, 
+    which are each keyed by a unique id String (usually the class name of the configuration object, 
+    to avoid namespacing issues). Then, the application can use 
+    SnapInContainerLoader.getSnapInContainer().getSnapIn(UID) to retrieve the configuration object
+    it desires. Paired with the namespace-awareness of OPL, the snap-in framework can support and 
+    consolidate an incredible range of configuration information within easy reach of any application
+    component. No more passing configuration objects as parameters to level after level of nested
+    constructors. No more custom singletons serving configuration information in non-standard ways.
+    No more x.getIntegerProperty("some.unique.key"), paired with management of the unique keys via
+    constants class. This is better. Trust us.
+  </description>
+  
   <dependencies>
     <dependency>
       <groupId>commonjava</groupId>

Index: project.properties
===================================================================
RCS file: /cvsroot/commonjava/commonjava-projects/commonjava-config/project.properties,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- project.properties	18 Sep 2003 00:42:46 -0000	1.1
+++ project.properties	18 Feb 2004 06:11:01 -0000	1.2
@@ -3,3 +3,4 @@
 maven.repo.central=www.commonjava.org
 maven.repo.central.directory=/usr/local/maven-repository
 
+maven.multiproject.includes=projects/**/project.xml