External API Interface

The sample codes to make a specific call are given in the following:

Sample code to make GET API call

(http://10.93.42.12:9089/irf-provider-container/api/v1.0.0/product/products/1234)
HttpClientRequest request = new HttpClientRequest.Builder().basePath("http://10.93.42.12:9089/irf-provider-container/api/").resourcePath("v1.0.0/product/products/1234").build();
Response<String> response = ServiceAdapterFactory.getServiceAdapter().get(request);
process(response.getBody().toString());

Sample code to make PUT API call

HttpClientRequest request = new HttpClientRequest.Builder().body(“Sample payload”).addHeader("Content-Type", "application/xml").basePath("http://10.93.42.12:9089/irf-provider-container/api/").resourcePath("v1.0.0/product/products/1234").build();   //Default Content - Type: appliction/json
Response<String> response = serviceAdapter.put(request);
process(response.getBody().toString());

Sample code to make POST API call

HttpClientRequest request = new HttpClientRequest.Builder().body(“Sample payload”).addHeader("Content-Type", "application/xml").basePath("http://10.93.42.12:9089/irf-provider-container/api/").resourcePath("v1.0.0/product/products/1234").build();       //Default Content - Type: appliction/json
Response<String> response = serviceAdapter.post(request);
process(response.getBody().toString());

Sample code to make DELETE API call

HttpClientRequest request = new HttpClientRequest.Builder().basePath("http://10.93.42.12:9089/irf-provider-container/api/").resourcePath("v1.0.0/product/products/1234").build();
Response<String> response = serviceAdapter.delete(request);
process(response.getBody().toString());

IRIS API requires security headers that are mandatory to process or forward the request to the external calls.

Sample code to support IRIS Security Headers is given below:

HttpRequest<String> request = new HttpClientRequest.Builder().context(context)
                                                .basePath("http://localhost:8080/iris").build();
Response<String> response = serviceAdapter.get(request);

The configurable properties of environment variables are shown below.

There are three types of microservice framework classes:

• ServiceAdapter - It is a generic adapter interface to make synchronous calls to external service. (example: get(), put(), post(), send(), receive(), ...)
• HttpServiceAdapter - It is an implementation of ServiceAdapter, which invokes external HTTP APIs. (handles retries, timeouts)
• ServiceAdapterFactory - It is used to get ServiceAdapter implementation. (This factory produces only HttpServiceAdapter.)

You can implement microservice specific integration with external service as shown in the following.

IntegrationService - define an interface for microservice specific contract.

IntegrationServiceImpl is an implementation class of IntegrationService which in turn uses microservice framework ServiceAdapter to call external service.

A sample IRIS API client code in Marketing Catalog service is given below. It builds request, call IntegrationServiceImpl methods and get the response.

IntegrationService service = IntegrationServiceImpl.getInstance();
Response<String> response = service.getMarketingCatalogInfo(buildHttpRequest(requiredDetails));
processResponse(response.getBody().toString());

Microservices rely on data streaming based platform to receive data events from the Product system. In the case of Temenos Transact, DES platform of Temenos Transact is used to receive Events.