IBM Cloudantを使いたいと思うことあるかもしれませんが、QiitaにはNodeRedの記事が多いですね。。。
javaで使いたい人向けの記事があまりないので入門編として掲載します。
また、IBMのCloud Foundryにデプロイするまで書きます。

dependency

Spring boot 2.0.4
cloudant-client 2.12.0
okhttp3 3.11.0
※ okhttp3についてjava 1.7以上が必須なので、パフォーマンスなどを気にしなければ省いても良い

cloudantの認証について

cloudantの認証も以前はHMAC keyを発行しなければならなかったのですが、
2018/08/21　現在ではHMAC、VCAP_SERVICES、IAM API key、ローカル認証やaccount endpoint？など多彩な認証によって認証が可能なようです。

どの認証方式でも良いのですが、今回はローカル環境とCloud Foundry環境の違いを気にすることなくかけるVCAP_SERVICESを利用します。

Cloud FoundryとCludantの接続、VCAP_SERVICEの取得

Cludantを起動してCloud Foundryに接続し、VCAP_SERVICESに接続するまでを記載します。

Cloudantを作成する

cloudantを作成します。

できたらDashboardにアクセスしDBを作成してデータを登録します。

Cloud Foundryを作成しCloudantを接続する

Cloud Foundryを作成します。サービスはあとで書き換えますが一応Tomcatで作成しています。

作成できたらCloudantを接続します。

とりあえずIAMを自動作成します。

指示に従ってアプリを再起動します。

VCAP_SERVICESを取得する

Cloud Foundryにアクセスし、Runtimeのタブを開くとEnvironment Variablesの項目にVCAP_SERVEICEが作成されています。

application.ymlやapplication.propertiesに登録する際は、JSONの改行を消して１行にして記載しましょう！

実装

propertiesファイルにVCAP_SERVEICESを１行にしたものを記載します。1
また、この設定でCloud Foundry環境にデプロイした場合、変数の優先度の関係でローカルではpropertiesの変数、本番ではCloud Foundryの変数が使われるようになり良い感じに開発できます。

application.properties

VCAP_SERVICES={ YOUR_VCAP_SERVICES_JSON : YOUR_JSON_PROPERTIES }

CloudantConfiguration.java

@Configuration
public class CloudantConfiguration {

    @Value("${VCAP_SERVICES}")
    private String vcapService;

    @Bean
    public CloudantClient cloudantClient()  {
        return ClientBuilder.bluemix(vcapService).build();
    }

}

受け取るDaoを作成していない場合はJsonObjectで受け取るのが良いです。
cloudantのライブラリがデフォルトで使用しているclassなので問題なく動作します。

CloudantdemoApplication.java

@RestController
@SpringBootApplication
public class CloudantdemoApplication {

	@Autowired
	CloudantClient cloudantClient;

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

	@RequestMapping("/")
	public String index() {
		Database db = cloudantClient.database("users",false);
		QueryResult<JsonObject> result  = db.query(new QueryBuilder(eq("name","LLENN")).build(), JsonObject.class);
		return result.getDocs().toString();
	}
}

$ mvn spring-boot:runなどでアプリを実行し、curlを投げると以下のように返却されます。

$ curl http://localhost:8080/
[{"_id":"18f6e5d603317e7a8189513270bc6e28","_rev":"1-487469bb37faf2e391ce4f8897b54e75","name":"LLENN"}]

Cloud Foundryにデプロイする

pom.xmlでwarを出力するように設定し、
ソースコードをビルドします。

$ mvn -DskipTests=true package

作成した環境にデプロイします。
IBM Cloud CLIのbxコマンドを使用します。

# bx コマンドでログインします。
$ bx login

# cloud foundryの環境を選択します。
$ bx target --cf

# アプリの一覧を取得します。
$ bx cf apps

名前           要求された状態   インスタンス   メモリー   ディスク   URL
Cludant-Demo   started          1/1            768M       1G         Cludant-Demo.mybluemix.net

# アプリをCloud Foundryにデプロイします。
$ bx cf push Cludant-Demo -p ./target/cloudantdemo-0.0.1-SNAPSHOT.war -b https://github.com/cloudfoundry/java-buildpack.git
...
...
     状態   開始日時               CPU    メモリー       ディスク     詳細
# 0   実行   2018-09-01T00:00:00Z   0.0%   1.1M of 768M   1.3M of 1G

自動でCloud Foundryが起動されるので、URLにcurlでアクセスしてみます。

$ curl https://Cludant-Demo.mybluemix.net/
[{"_id":"18f6e5d603317e7a8189513270bc6e28","_rev":"1-487469bb37faf2e391ce4f8897b54e75","name":"LLENN"}]

確認が終わったら停止させておきましょう。

$ bx cf stop Cludant-Demo

備考

ソースコードは以下です。
https://github.com/amanoese/cloudant-demo

参考

https://console.bluemix.net/docs/cli/index.html
https://github.com/cloudant/java-cloudant