Java Cloudant Sample

This application demonstrates how to use the Bluemix Cloudant NoSQL Database service. It helps users organize their favorite files. The UI talks to a RESTful JAX-RS CRUD backend API.

Building and running the application using the command-line

Open the Bluemix dashboard, create/select your Cloudant service -> Service Credentials -> View Credentials

Copy the credentials to src/main/java/example/nosql/CloudantClientMgr.java

  user = "REPLACE_WITH_CLOUDANT_USERNAME";
  password = "REPLACE_WITH_CLOUDANT_PASSWORD";

Execute full Maven build to create the target/JavaCloudantApp.war file:
```
$ mvn clean install
```
Download and start a local Liberty server with the application:
```
$ mvn liberty:run-server
```
Once the server is running, the application will be available under http://localhost:9080/JavaCloudantApp.
Update the application details in the manifest.yml file. Change the name field to your Bluemix Application Name and change the services field to your Cloudant service instance name. Connect and Login to Bluemix using the following commands:
```
$ cf api https://api.ng.bluemix.net
$ cf login -u username -o org_name -s space_name
```
(You can find the org_name, space_name on the Bluemix dashboard and replace username with the mail-id associated with the account)

Use the following command to push the application to Bluemix:
```
$ cf push
```

Developing and Deploying using Eclipse

IBM® Eclipse Tools for Bluemix® provides plug-ins that can be installed into an existing Eclipse environment to assist in integrating the developer's integrated development environment (IDE) with Bluemix.

Download and install IBM Eclipse Tools for Bluemix.
Import this sample into Eclipse using File -> Import -> Maven -> Existing Maven Projects option.
Create a Liberty server definition:

In the Servers view right-click -> New -> Server
Select IBM -> WebSphere Application Server Liberty
Choose Install from an archive or a repository
Enter a destination path (/Users/username/liberty)
Choose WAS Liberty with Java EE 7 Web Profile
Continue the wizard with default options to Finish

Open the Bluemix dashbaord create/select your Cloudant service -> Service Credentials -> View Credentials

Copy the credentials to src/example/nosql/CloudantClientMgr.java

  user = "REPLACE_WITH_CLOUDANT_USERNAME";
  password = "REPLACE_WITH_CLOUDANT_PASSWORD";

Run your application locally on Liberty:

Right click on the JavaCloudantApp sample and select Run As -> Run on Server option
Find and select the localhost Liberty server and press Finish
In a few seconds, your application should be running at http://localhost:9080/JavaHelloWorldApp/

Create a Bluemix server definition:

In the Servers view, right-click -> New -> Server
Select IBM -> IBM Bluemix and follow the steps in the wizard.
Enter your credentials and click Next
Select your org and space and click Finish

Run your application on Bluemix:

Right click on the JavaCloudantApp sample and select Run As -> Run on Server option
Find and select the IBM Bluemix and press Finish
A wizard will guide you with the deployment options.
Select your Cloudant service on the Services step
In a few minutes, your application should be running at the URL you chose.

Now you have your code running locally and on the cloud!

IBM-Cloud/java-cloudant

Java Cloudant Sample

Building and running the application using the command-line

Developing and Deploying using Eclipse