JAVA-806: Create JNDI ObjectFactory reference documentation

Author: jyemin

docs/reference/content/driver/reference/connecting/index.md

@@ -10,8 +10,9 @@ title = "Connecting"
 
 ## Connecting
 
-The reference documentation for connecting to a MongoDB server deployment is divided into three sections:   
+The reference documentation for connecting to a MongoDB server deployment is divided into the following sections:
 
 - [Connection Settings]({{<relref "driver/reference/connecting/connection-settings.md">}}): documentation of the various ways to specify the properties of a connection
 - [Authenticating]({{<relref "driver/reference/connecting/authenticating.md">}}): detailed documentation of the various ways to specify authentication credentials
 - [SSL]({{<relref "driver/reference/connecting/ssl.md">}}): Detailed documentation of the various ways to specify the properties of an SSL connection
+- [JNDI]({{<relref "driver/reference/connecting/jndi.md">}}): Detailed documentation of the various ways to configure JNDI to return MongoClient instances

docs/reference/content/driver/reference/connecting/jndi.md

@@ -0,0 +1,86 @@
++++
+date = "2015-03-19T12:53:26-04:00"
+title = "JNDI"
+[menu.main]
+  parent = "Sync Connecting"
+  identifier = "Sync JNDI"
+  weight = 30
+  pre = "<i class='fa'></i>"
++++
+
+## Java Naming and Directory Interface (JNDI)
+
+The driver includes a [JNDI](http://docs.oracle.com/javase/8/docs/technotes/guides/jndi/index.html) ObjectFactory implementation,
+[`MongoClientFactory`]({{< apiref "com/mongodb/client/jndi/MongoClientFactory" >}}), that returns `MongoClient` instances based on a
+[connection string](http://docs.mongodb.org/manual/reference/connection-string/).
+
+## Examples
+
+The configuration of the `MongoClientFactory` differs depending on the application server. Below are examples of a few popular ones.
+
+### Wildfly (formerly JBoss)
+
+1. In a [Wildfly](http://wildfly.org/) installation, create a new module for MongoDB at `modules/system/layers/base/org/mongodb/main`.
+
+2. Copy the mongo-java-driver jar file into the module.
+
+3. Add the following module.xml file into the module:
+
+        <module xmlns="urn:jboss:module:1.3" name="org.mongodb">
+           <resources>
+               <resource-root path="mongo-java-driver-3.3.0.jar"/>
+           </resources>
+           <dependencies>
+               <module name="javax.api"/>
+               <module name="javax.transaction.api"/>
+               <module name="javax.servlet.api" optional="true"/>
+           </dependencies>
+        </module>
+
+
+4. Add a binding to JBoss's naming subsystem configuration that references the above module, the `MongoClientFactory` class, and the
+connection string for the MongoDB cluster.
+
+        <subsystem xmlns="urn:jboss:domain:naming:2.0">
+            <bindings>
+                <object-factory name="java:global/MyMongoClient" module="org.mongodb" class="com.mongodb.client.jndi.MongoClientFactory">
+                    <environment>
+                        <property name="connectionString" value="mongodb://localhost:27017"/>
+                    </environment>
+                 </object-factory>
+            </bindings>
+            <remote-naming/>
+        </subsystem>
+
+A MongoClient instance will be accessible via the JNDI name `java:global/LocalMongoClient`.
+
+### Tomcat
+
+1. In a [Tomcat](http://tomcat.apache.org/) installation, copy the mongo-java-driver jar file into the lib directory.
+
+2. In context.xml of a web application, add a resource that references the `MongoClientFactory` class, and the connection string for the
+MongoDB cluster:
+
+        <Resource name="mongodb/MyMongoClient"
+                  auth="Container"
+                  type="com.mongodb.MongoClient"
+                  closeMethod="close"
+                  factory="com.mongodb.client.jndi.MongoClientFactory"
+                  singleton="true"
+                  connectionString="mongodb://localhost"/>
+
+3. In web.xml of a web application, add a reference to the above resource:
+
+        <resource-ref>
+            <res-ref-name>
+                mongodb/MyMongoClient
+            </res-ref-name>
+            <res-type>
+                com.mongodb.MongoClient
+            </res-type>
+            <res-auth>
+                Container
+            </res-auth>
+        </resource-ref>
+
+A MongoClient instance will be accessible via the JNDI name `mongodb/MyMongoClient` in the `java:comp/env` context.