CouchDB connection

1. Log onto Jelastic.

2. Create environment with CouchDB database:

create couchdb environment

3. Check your email box for getting credentials to access CouchDB node:

email couchdb node added

4. Then create a file mydb.cfg in Config Manager (folder HOME). This file contains information on connecting to CouchDB. This info will be read by your application:

database connection data

5. In this step you have to prepare part of java code that creates connection to your DB:

 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
import com.fourspaces.couchdb.*;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.Properties;
import java.util.logging.Level;
import java.util.logging.Logger;

public class CouchdbConnector {

    public boolean createDatabase(String name) {
        try {
            //Read file mydb.cfg
            Properties prop = new Properties();
            prop.load(new FileInputStream(System.getProperty("user.home") + "/mydb.cfg"));
            
            //Getting info we need: host, port, username, password
            String host = prop.getProperty("host").toString();
            int port = Integer.parseInt(prop.getProperty("port").toString());           
            String username = prop.getProperty("username").toString();
            String password = prop.getProperty("password").toString();
            
            Session dbSession = new Session(host, port, username, password);
         
            dbSession.createDatabase(name);

            try {
                dbSession.getDatabase(name);
            } catch (Exception e) {
                return false;
            }            
        } catch (IOException ex) {
            Logger.getLogger(CouchdbConnector.class.getName()).log(Level.SEVERE, null, ex);
        }
        
        return true;
    }   
}

NOTE: you have to upload all libraries that CouchDB connection needs!

6. Deploy application: couchdb.war

7. Run deployed application and input database name you want to create:

run example application

Input database name:

input database name

8. Check CouchDB server if it contains “new” database:

  • run CouchDB instance in browser: open couchdb admin

  • input credentials that you got on e-mail; couchdb  admin log in

  • check database presence. check database

What’s next?