Java Connection to MongoDB
Create Environment
1. Log in to your Apiqcloud account.
2. Create an environment with MongoDB instance (available within the NoSQL section). The preferred application server for your app to be deployed to can be located in the same or separate environment (as an example, we’ve added Tomcat 7):
Click Create and wait a couple of minutes for your environment to appear at the dashboard.
MongoDB Configurations
1. Check your email inbox - it should contain a message from Robot@Apiqcloud with the database details:
2. Click the Open in browser button for the MongoDB node within your dashboard or use the Access URL from the email to access the database admin panel.
Log in using the abovementioned credentials.
3. Create a new database by switching to the Databases tab and typing a Name for it (e.g. MongoDB-connect) within the Create Database form.
Click Save to continue.
4. Next, you need to create a user for this DB - thus, navigate to the Execute tab and choose your newly created database via the corresponding drop-down list.
Then type the following command within the input frame above:
db.createUser({ user: "user_name", pwd: "password", roles:[{ role: "readWrite", db: "db_name"}]})
where
- user_name - the desired name of your new DB user
- password - password for this user
-
db_name - the name of the database the newly created user will get the read/write permissions for
After that, click the Execute button and wait for the success response.
5. Now, return to the dashboard and create a separate file for storing database-connection information.
Click the Config button next to your application server in the corresponding environment (Tomcat 7 in our case).
In the opened tab, create a new mydb.cfg file inside the home directory and specify the following strings there:
host={db_access_url}dbname={db_name}
user={user_name}
password={password}
where
- {db_access_url} - link to the database admin panel (find it within the corresponding email or click Open in the browser next to your MongoDB node and copy it from the address bar) without https://part
- {db_name} - name of the created database (MongoDB-connect in our case)
- {user_name} - the name of the DB user you’ve assigned to this database (dbuser in our case)
-
{password} - the corresponding user’s password
Do not forget to Save the changes.
Application Deployment
1. Now you can deploy your project to the prepared environment.
As an example, here is the code of our application, intended to test the connection to our MongoDB node.
MongoManager.java :
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
package example;import com.mongodb.*;import com.mongodb.client.MongoDatabase;import org.bson.Document;import java.io.FileInputStream;import java.io.IOException;import java.util.Arrays;import java.util.Date;import java.util.Properties;public class MongoManager { static String host, dbname, user, password; public void addData(int repeats) { try { Properties prop = new Properties(); prop.load(new FileInputStream(System.getProperty("user.home") + "/mydb.cfg")); host = prop.getProperty("host").toString(); dbname = prop.getProperty("dbname").toString(); user = prop.getProperty("user").toString(); password = prop.getProperty("password").toString(); System.out.println("host: " + host + "\ndbname: " + dbname + "\nuser: " + user + "\npassword: " + password); MongoCredential credential = MongoCredential.createCredential(user, dbname, password.toCharArray()); MongoClient mongoClient = new MongoClient(new ServerAddress(host), Arrays.asList(credential)); MongoDatabase db = mongoClient.getDatabase(dbname); try { db.getCollection("mycollection"); } catch (Exception e) { db.createCollection("mycollection", null); System.out.println("Repeats: " + repeats); for (int i = 1; i <= repeats; i++) { Document document = new Document("data", new Date()); db.getCollection("mycollection").insertOne(document); System.out.println("INFO: row added " + document); } } finally { mongoClient.close(); } } catch (IOException ex) { } }} |
2. Any application can be deployed using either Apiqcloud Deployment Manager (with a local file/URL as a source) or Maven (for deployment from GIT/SVN).
For testing, you can try our ready-to-use mongoclient.war project, which already contains the appropriate connector driver (or download its sources and adjust it in any preferred way).
3. As a result, you’ll get an environment similar to the one below:
Connection Check-Up
1. Click Open in Browser next to your environment with our example app deployed. You’ll see a new window opened with the simple MongoDB Manager form shown.
Type the desired number of rows (for being added to the corresponding database) into the appropriate field and click the Insert rows button.
2. Wait a moment until the page stops updating and return to the MongoDB admin panel.
Navigate to the mongodb-connect database within the list to the left and check for the new my-collection inside - it should include the above-stated amount of records, 5 in our case.
As you can see, everything works fine, as an application could connect to our DB. Now you can use the admin panel to perform any other required operations to your database in a similar way.
