Java Connection to CouchDB

1. Log onto CirrusGrid.

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:

import com.fourspaces.couchdb.*;
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);

            try {
            } 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

Powered by BetterDocs