This is a small Java sample application showing how to use the Cloud Foundry client library to connect to and interact with a Cloud Foundry instance.

To build the program, follow these steps:

$ git clone https://github.com/scottfrederick/cf-java-client
$ cd cf-java-client
$ ./gradlew assemble

The program can be run a few different ways.

You can authenticate to Cloud Foundry with a username and password by passing those as parameters along with the target when the program is launched:

$ java -jar build/libs/cf-java-client-1.0.jar -t https://api.run.pivotal.io -s development -u <username> -p <password>

You can authenticate to Cloud Foundry with a pair of OAuth tokens granted via an OAuth registration process. If you have an OAuth access token and refresh token and a client ID attached to the tokens, you can pass these as parameters to the program:

$ java -jar build/libs/cf-java-client-1.0.jar -t https://api.run.pivotal.io -s development -c <client ID> -a <access token> -r <refresh token>

You can run the program using tokens saved by the cf command line tool instead of providing a username and password. To do this, you need to target and log into a Cloud Foundry service using cf. See the Getting Started guide for Pivotal's Cloud Foundry instance for further information. Using cf to target and log in will save account credentials in a file ~/.cf/tokens.yml.

After targeting and logging in with cf, you can run the program and target a specific Cloud Foundry service using tokens from ~/.cf/tokens.yml:

$ java -jar build/libs/cf-java-client-1.0.jar -t https://api.run.pivotal.io -s development