Added simpleJNDI as a provided library

The easiest method to access sql databases in metafacture is to access
them via JNDI. This commit adds a simple JNDI implementation to the
provided-libs folder.

Author: cboehme

pom.xml

@@ -231,7 +231,21 @@
 		<dependency>
 			<groupId>org.slf4j</groupId>
 			<artifactId>slf4j-log4j12</artifactId>
-			<version>1.7.2</version>
+			<version>1.7.6</version>
+			<scope>provided</scope>
+		</dependency>
+
+		<dependency>
+			<groupId>simple-jndi</groupId>
+			<artifactId>simple-jndi</artifactId>
+			<version>0.11.4.1</version>
+			<scope>provided</scope>
+		</dependency>
+		
+		<dependency>
+			<groupId>commons-dbcp</groupId>
+			<artifactId>commons-dbcp</artifactId>
+			<version>1.4</version>
 			<scope>provided</scope>
 		</dependency>
 

src/main/assembly/assembly.xml

@@ -67,8 +67,7 @@
 			<directory>${project.basedir}/src/main/config/</directory>
 			<outputDirectory>config/</outputDirectory>
 			<includes>
-				<include>java-options.conf</include>
-				<include>log4j.xml</include>
+				<include>**/*</include>
 			</includes>
 			<directoryMode>0755</directoryMode>
 			<fileMode>0644</fileMode>

src/main/config/java-options.conf

@@ -5,10 +5,17 @@
 # Undefined variables remain in the configuration. 
 
 -Xmx512m
--Dlog4j.configuration="file:///$METAFACTURE_HOME/config/log4j.xml"
+
 -Dflux.pluginsdir="$METAFACTURE_HOME/plugins"
 -Dflux.provideddir="$METAFACTURE_HOME/provided-libs"
 
+# Configure log4j to read its configuration from a file:
+-Dlog4j.configuration="file:///$METAFACTURE_HOME/config/log4j.xml"
+
+# Configure simple jndi as default jndi provider:
+-Djava.naming.factory.initial=org.osjava.sj.SimpleContextFactory
+-Dorg.osjava.sj.root="file:///$METAFACTURE_HOME/config/jndi"
+
 # Append additional options defined in the 
 # environment (The start-up script ensures 
 # that this variable is always defined):

src/main/config/jndi/README.md

@@ -0,0 +1,40 @@
+Place your JNDI properties files in this directory. By default 
+metafacture-runner uses [simpleJNDI](http://code.google.com/p/osjava/wiki/SimpleJNDI) 
+as JNDI provider.
+
+# Examples
+
+One of the most common use cases of JNDI is to provide data sources for
+JDBC. However, JNDI can be used to pass other variables into a program
+as well. The following to examples demonstrate how to define data sources
+and other values. 
+
+More elaborate examples can be found in the simpleJDNI documentation which
+is part of the [binary download package](http://code.google.com/p/osjava/downloads/detail?name=simple-jndi-0.11.4.1.zip&can=2&q=)
+of simpleJNDI.
+
+## Data sources
+
+To register a data source with the name `MySqlDB`, create a property 
+file named `MySqlDB.properties` with the following contents:
+
+```
+type=javax.sql.DataSource
+driver=com.mysql.jdbc.Driver
+url=jdbc:mysql://localhost:3306/DBNAME
+user=USER
+password=PASSWORD
+```
+
+## Other values
+
+Other values can be made available via JNDI by creating property files
+such as the following:
+
+```
+enabled = true
+enabled.type = java.lang.Boolean
+```
+
+If this file is saved as `debug.properties`, the value of enabled can 
+be accessed as follows: `debug.enabled`.