The is a library to provide Spring developers easy configuration of the official Cloudant library for Java.

The library is split into two parts:

• cloudant-spring-boot-starter for Spring Boot applications

• cloudant-spring-framework for Spring Framework applications

• Installation and Usage

• Getting Started

• Related Documentation

• Development

  • Contributing
  • Test Suite
  • Using in Other Projects
  • License
  • Issues

Gradle:

dependencies {
    compile group: 'com.cloudant', name: 'cloudant-spring-boot-starter', version: '0.0.1'
}

Maven:

<dependency>
  <groupId>com.cloudant</groupId>
  <artifactId>cloudant-spring-boot-starter</artifactId>
  <version>0.0.1</version>
</dependency>

Gradle:

dependencies {
    compile group: 'com.cloudant', name: 'cloudant-spring-framework', version: '0.0.1'
}

Maven:

<dependency>
  <groupId>com.cloudant</groupId>
  <artifactId>cloudant-spring-framework</artifactId>
  <version>0.0.1</version>
</dependency>

This section contains simple examples of connecting to Cloudant using the two libraries.

To enable auto-configuration you must provide the following properties to define the connection to your Cloudant instance:

• cloudant.url
• cloudant.username
• cloudant.password

For example in an application.properties file:

cloudant.url=http://cloudant.com
cloudant.username=myUsername
cloudant.password=myPassword

Spring Boot will create a com.cloudant.client.api.CloudantClient bean that can be used to interact with your Cloudant instance:

@Autowired
private CloudantClient client;

public List<String> getAllDbs() {
    return client.getAllDbs();
}

The Spring Boot starter will also provide a com.cloudant.client.api.Database bean if your provide a cloudant.db property. For example:

cloudant.url=http://cloudant.com
cloudant.username=myUsername
cloudant.password=myPassword
cloudant.db=myDb

@Autowired
private Database db;

public List<Greeting> getAllDocsAsGreetings() {
    return List<Greeting> allDocs = db.getAllDocsRequestBuilder().includeDocs(true).build().getResponse().getDocsAs(Greeting.class);
}

To provide custom connection options you can override the com.cloudant.client.api.ClientBuilder bean and provide your own properties:

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    @Value("${cloudant.account}")
    private String account;

    @Value("${cloudant.username}")
    private String username;

    @Value("${cloudant.password}")
    private String password

    @Bean
    public ClientBuilder builder() {
        ClientBuilder builder = ClientBuilder
            .account(this.account)
            .username(this.username)
            .password(this.password);
        return builder;
    }
}

application.properties:

cloudant.account=myAccount
cloudant.username=myUsername
cloudant.password=myPassword

You must provide the following properties to define the connection to your Cloudant instance:

• cloudant.url
• cloudant.username
• cloudant.password

To enable the creation of the com.cloudant.client.api.CloudantClient bean you must add an com.cloudant.spring.framework.EnableCloudant annotation to your application configuration:

@Configuration
@EnableWebMvc
@EnableCloudant
@ComponentScan
public class SpringConfig {}

@Autowired
private CloudantClient client;

public List<String> getAllDbs() {
    return client.getAllDbs();
}

• Cloudant library for Java
• Cloudant documentation
• Cloudant Learning Center
• Spring Boot documentation
• Spring Framework documentation

For information about contributing, building, and running tests see the CONTRIBUTING.md.

The preferred approach for using cloudant-spring in other projects is to use the Gradle or Maven dependency as described above.

Copyright © 2017 IBM Corp. All rights reserved.

Licensed under the apache license, version 2.0 (the "license"); you may not use this file except in compliance with the license. you may obtain a copy of the license at

http://www.apache.org/licenses/LICENSE-2.0.html

Unless required by applicable law or agreed to in writing, software distributed under the license is distributed on an "as is" basis, without warranties or conditions of any kind, either express or implied. See the license for the specific language governing permissions and limitations under the license.

Before opening a new issue please consider the following:

• Please try to reproduce the issue using the latest version.
• Please check the existing issues to see if the problem has already been reported. Note that the default search includes only open issues, but it may already have been closed.
• When opening a new issue here in github please complete the template fully.