Over a million developers have joined DZone.

Practical Reactor Operations: Retrieve Cloud Foundry App Details

DZone's Guide to

Practical Reactor Operations: Retrieve Cloud Foundry App Details

You can use Reactor, or rather the CF-Java-Client library built on it, get access to Cloud Foundry's Cloud Controller API to obtain, transform, and combine data.

· Java Zone
Free Resource

Bitbucket is for the code that takes us to Mars, decodes the human genome, or drives your next car. What will your code do? Get started with Bitbucket today, it's free.

CF-Java-Client is a library that enables programmatic access to a Cloud Foundry Cloud Controller API. It is built on top of Project Reactor, an implementation of the Reactive Streams specification, and it is a fun exercise to use this library to do something practical in a Cloud Foundry environment.

Consider a sample use case: Given an application ID, I need to find a little more detail on this application — more details of the application along with the details of the organization and the space that it belongs to.

To start with, the basis of all API operations with CF-Java-Client is a type unsurprisingly called the CloudFoundryClient(org.cloudfoundry.client.CloudFoundryClient). CF-Java-Client's GitHub page 

has details on how to get ahold of an instance of this type.

Given a CloudFoundryClient instance, the details of an application given its id can be obtained as follows:

Mono<GetApplicationResponse> applicationResponseMono = this.cloudFoundryClient

Note that the API returns a reactor "Mono" 

type, this is in general the behavior of all the API calls of cf-java-client.

  • If an API returns one item then typically a Mono type is returned
  • If the API is expected to return more than one item then a Flux type is returned, and
  • If the API is called purely for side effects — say printing some information then it returns a Mono<Void> type

The next step is to retrieve the space identifier from the response and make an API call to retrieve the details of the space. That looks like this:

Mono<Tuple2<GetApplicationResponse, GetSpaceResponse>> appAndSpaceMono = applicationResponseMono
  .and(appResponse -> this.cloudFoundryClient.spaces()

Here, I am using an "and" 

operator to combine the application response with another Mono that returns the space information. The result is a "Tuple2" 

type holding both pieces of information — the application detail and the detail of the space that it is in.

Finally, to retrieve the organization that the app is deployed in:

Mono<Tuple3<GetApplicationResponse, GetSpaceResponse, GetOrganizationResponse>> t3 =
  appAndSpaceMono.then(tup2 -> this.cloudFoundryClient.organizations()
      .map(orgResp -> Tuples.of(tup2.getT1(), tup2.getT2(),

Here, a "then" 

operation is being used to retrieve the organization detail. Using the ID from the previous step and the result added onto the previous tuple, we create a Tuple3 

type holding the "Application Detail," "Space Detail," and the "Organization Detail". "Then" is the equivalent of a

flatMap operator familiar in the Scala and ReactiveX world.

This essentially covers the way you would typically deal with the CF-Java-Client library and use the fact that it is built on the excellent Reactor library, and its collection of very useful operators, to get results together.

Now, we move onto the final step of transforming the result to a type that may be more relevant to your domain (handling any errors along the way):

Mono<AppDetail> appDetail =  
   t3.map(tup3 -> {
       String appName = tup3.getT1().getEntity().getName();
       String spaceName = tup3.getT2().getEntity().getName();
       String orgName = tup3.getT3().getEntity().getName();
       return new AppDetail(appName, orgName, spaceName);
}).otherwiseReturn(new AppDetail("", "", ""));

If you are interested in trying out a working sample, I have an example available in my GitHub repo here.

And the code shown in the article is available here.

Bitbucket is the Git solution for professional teams who code with a purpose, not just as a hobby. Get started today, it's free.

cloud foundry ,java ,reactor ,cloud controller api ,tutorial

Published at DZone with permission of Biju Kunjummen, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.


Dev Resources & Solutions Straight to Your Inbox

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.


{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}