Connect to MongoDB by Using a JNDI Datasource

1. In a Wildfly installation, create a new module for MongoDB at modules/system/layers/base/org/mongodb/main. Copy the following jar files into the module:

   • mongodb-driver-sync-5.2.0.jar

   • mongodb-driver-core-5.2.0.jar

   • bson-5.2.0.jar

   • bson-record-codec-5.2.0.jar

   Add the following module.xml file into the module:

   module.xml

   <module xmlns="urn:jboss:module:1.9" name="org.mongodb">
      <resources>
         <resource-root path="bson-5.2.0.jar"/>
         <resource-root path="bson-record-codec-5.2.0.jar"/>
         <resource-root path="mongodb-driver-core-5.2.0.jar"/>
         <resource-root path="mongodb-driver-sync-5.2.0.jar"/>
      </resources>
      <dependencies>
         <module name="javax.api"/>
         <module name="javax.transaction.api"/>
         <module name="javax.servlet.api" optional="true"/>
      </dependencies>
   </module>

2. Add a binding to the naming subsystem configuration that references the preceding 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.MongoClientFactory">
            <environment>
               <property name="connectionString" value="<connection string uri>"/>
            </environment>
         </object-factory>
      </bindings>
      <remote-naming/>
   </subsystem>

   Note

   Replace the placeholder connection value in the property tag with a value that points to your MongoDB installation.

This makes a MongoClient instance discoverable through the JNDI name MyMongoClient in the java:global context.

1. Copy the following jar files into the lib directory of your Tomcat installation:

   • mongodb-driver-sync-5.2.0.jar

   • mongodb-driver-core-5.2.0.jar

   • bson-5.2.0.jar

   • bson-record-codec-5.2.0.jar

2. In the context.xml file of your 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.client.MongoClient"
      closeMethod="close"
      factory="com.mongodb.client.MongoClientFactory"
      singleton="true"
      connectionString="<connection string uri>"/>

   Note

   Replace the placeholder URI in the connectionString attribute with a value that points to your MongoDB installation.

3. In web.xml of your application, add a reference to the MongoClientFactory resource defined in the previous step:

   <resource-ref>
     <res-ref-name>
       mongodb/MyMongoClient
     </res-ref-name>
     <res-type>
       com.mongodb.MongoClient
     </res-type>
     <res-auth>
       Container
     </res-auth>
   </resource-ref>

This makes a MongoClient instance discoverable through the JNDI name mongodb/MyMongoClient in the java:comp/env context.