Introduction to Currency Conversion and Currency Exchange Service

In this section, we will create a couple of microservices: CurrencyCalculationService and CurrencyExchangeService.

Note: In this tutorial, we have quoted currency conversion service as a currency calculation service. Both the services have the same meaning, so don’t be confused.

Let’s understand the functionality of these services.

In the above figure, the CurrencyExchangeService uses JPA to talk to the database and returns the exchange value of the specific currency. For example, USD to INR conversion.

When we invoke CurrencyExchangeService, we need to pass two parameters: from(convert from), and to (convert to). For example, if we want to convert currency from USD to INR.

Consider the URL http://localhost:8000/currency-exchange/from/USD/to/INR. It retunes the following response:

  {  id: 101,  from: “USD”,  to: “INR”,  conversionMultiple: 72,  port: 8000  }  

The currency exchange service will return what the conversion multiple is. The conversion multiple means 1 USD is equal to 72 INR. The currency converter service uses a currency exchange service. Suppose the currency converter service wants to convert 100 USD to INR. So it will call the currency exchange service and will convert the specified amount that we have provided in the path parameter. For example:

http://localhost:8100/currency-converter/from/USD/to/INR/quantity/100

  {  Id: 101,  from: “USD”,  to: “INR”,  conversionMultiple: 72,  quantity: 100  totalCalculatedAmount: 7200,  port: 8000  }  

We will implement these two services in our example using Spring Cloud.

Setting up a currency-exchange-service

Step 1: Open the spring initializer http://start.spring.io.

Step 2: Select the Project: Maven Project, Language: Java, and Spring Boot version 2.2.0 M6 or above. Provide the Group name and Artifact ID. We have provided com.tutoraspire.microservices and currency-exchange-service, for group name and Artifact id respectively.

Introduction to Currency Conversion and Currency Exchange Service

Step 3: Add the dependencies Web, DevTools, Actuator, and Config Client.

Step 4: Click on the Generate Project button. It will download the zip file of the project.

Step 5: Extract it in the local disk.

Step 6: Import the project.

Click on File menu-> Import -> Existing Maven Projects -> Next -> Browse ->Select the project ->Finish

It takes some time to import. When the project import is done, it shows the following project directory. Do not consider the data.sql file in the directory, because we will create it later.

Introduction to Currency Conversion and Currency Exchange Service

Step 7: Open the application.properties file and configure the application name and port number.

application.properties

When we run the currency-exchange-service, it runs but does not perform any service. In the next step, we will implement code in the currency-exchange-service.

Hardcoded the currency-exchange-service

Now we will create a service that converts the currency from USD to INR.

Step 1: Create a class file (REST Controller) with the name CurrencyExchangeController in the package com.tutoraspire.microservices.currencyexchangeservice.

CurrencyExchangeController.java

  package com.tutoraspire.microservices.currencyexchangeservice;  import java.math.BigDecimal;  import org.springframework.boot.SpringApplication;  import org.springframework.boot.autoconfigure.SpringBootApplication;  import org.springframework.web.bind.annotation.GetMapping;  import org.springframework.web.bind.annotation.PathVariable;  import org.springframework.web.bind.annotation.RestController;  @SpringBootApplication  @RestController   public class CurrencyExchangeController   {  @GetMapping(“/currency-exchange/from/{from}/to/{to}”)//where {from} and {to} are path variable  public ExchangeValue retrieveExchangeValue(@PathVariable String from, @PathVariable String to)//from map to USD and to map to INR  {  return new  ExchangeValue(1000L, from, to, BigDecimal.valueOf(65));  }  }  

Step 2: Create a class file with the name ExchangeValue.

ExchangeValue.java

  package com.tutoraspire.microservices.currencyexchangeservice;  import java.math.BigDecimal;  public class ExchangeValue   {  private Long id;  private String from;  private String to;  private BigDecimal conversionMultiple;    public ExchangeValue()  {  }  //generating constructor using fields  public ExchangeValue(Long id, String from, String to, BigDecimal conversionMultiple) {  super();  this.id = id;  this.from = from;  this.to = to;  this.conversionMultiple = conversionMultiple;  }  //generating getters  public Long getId()   {  return id;  }  public String getFrom()   {  return from;  }  public String getTo()   {  return to;  }  public BigDecimal getConversionMultiple()   {  return conversionMultiple;  }  }  

Step 3: Run the CurrencyExchangeServiceApplication.java. It runs on the port 8000 that we have configured in the application.properties file.

We get the following response on the browser:

  {  id: 101,  from: “USD”,  to: “INR”,  conversionMultiple: 72,  port: 8000  }  

Setting up Dynamic port in the Response

The CurrencyExchangeService determines the exchange value of the currency. The CurrencyCalculationService uses the CurrencyExchangeService to determine the value of one currency in other currency. We will create multiple instances of the CurrencyExchangeService later in next topic.

At present, the service is running on port 8000. Later we will run it on port 8001, 8002, and so on. In the next step, we will set a port to the currency-exchange-service.

Step 1: Open the ExchangeValue.java file and add a port variable. Generate getters and setters for the port variable only.

ExchangeValue.java

  package com.tutoraspire.microservices.currencyexchangeservice;  import java.math.BigDecimal;  public class ExchangeValue   {  private Long id;  private String from;  private String to;  private BigDecimal conversionMultiple;  private int port;  public ExchangeValue()  {  }  //generating constructor using fields  public ExchangeValue(Long id, String from, String to, BigDecimal conversionMultiple) {  super();  this.id = id;  this.from = from;  this.to = to;  this.conversionMultiple = conversionMultiple;  }  //generating getters  public int getPort() {  return port;  }  public void setPort(int port) {  this.port = port;  }  public Long getId()   {  return id;  }  public String getFrom()   {  return from;  }  public String getTo()   {  return to;  }  public BigDecimal getConversionMultiple()   {  return conversionMultiple;  }  }  

We have already configured the application name and port number in the application.properties file, so need not to configure again.

Now pick up port number from the environment.

Step 3: Open the CurrencyExchangeController.java and get the property of the environment.

CurrencyExchangeController.java.

  package com.tutoraspire.microservices.currencyexchangeservice;  import java.math.BigDecimal;  import org.springframework.beans.factory.annotation.Autowired;  import org.springframework.boot.autoconfigure.SpringBootApplication;  import org.springframework.core.env.Environment;  import org.springframework.web.bind.annotation.GetMapping;  import org.springframework.web.bind.annotation.PathVariable;  import org.springframework.web.bind.annotation.RestController;  @SpringBootApplication  @RestController   public class CurrencyExchangeController   {  @Autowired  private Environment environment;  @GetMapping(“/currency-exchange/from/{from}/to/{to}”) //where {from} and {to} are path variable  public ExchangeValue retrieveExchangeValue(@PathVariable String from, @PathVariable String to)  //from map to USD and to map to INR  {  //taking the exchange value  ExchangeValue exchangeValue= new ExchangeValue (1000L, from, to, BigDecimal.valueOf(65));  //picking port from the environment  exchangeValue.setPort(Integer.parseInt(environment.getProperty(“local.server.port”)));  return exchangeValue;  }  }  

When we refresh the browser, the URL changes to: http://localhost:8000/currency-exchange/from/USD/to/INR.

  {  id: 1000,  from: “USD”,  to: “INR”  conversionMultiple: 65,  port: 8000  }  

At present CurrencyExchangeServiceApplication is running on port 8000.

Now we will run CurrencyExchangeServiceApplication on a different port number. For this, we have to change the port in the application.properties file from 8000 to 8001, 8002, etc. whichever we want.

Suppose we want to create two instances of the CurrencyExchangeServiceApplication. For this, we have to set port externally.

Let’s create an instance of the CurrencyExchangeServiceApplication that runs on the port 8001.

Step 1: Right-click on the project -> Run As -> Run Configurations.

Or click on the highlighted symbol -> Run Configurations.

Introduction to Currency Conversion and Currency Exchange Service

Step 2: Rename the CurrencyExchangeServiceAppication to CurrencyExchangeServiceAppication8000 and click on the Apply button.

Introduction to Currency Conversion and Currency Exchange Service

Step 3: Right-click on the CurrencyExchangeServiceApplication8000 -> Duplicate.

Introduction to Currency Conversion and Currency Exchange Service

It generates the duplicate file of CurrencyExchangeServiceApplication8000. We will run it on port 8001.

Step 4: Click on the Arguments tab and write –Dserver.port=8001 in the VM arguments text box. Click on the Apply and Run button, respectively.

Note: Whatever value we are passing in the VM arguments, it overwrites the configuration of the application.properties file.

Introduction to Currency Conversion and Currency Exchange Service

After clicking on the Run button, it starts running on port 8001.

Step 5: Change the port number in the URL http://localhost:8001/currency-exchange/from/USD/to/INR and press enter key. We get the following response:

  {  id: 1000,  from: “USD”,  to: “INR”,  conversionMultiple: 65,  port: 8001  }  

Now we have two instances of CurrencyExchangeServiceApplication that are running on two different ports 8000 and 8001.

Click here to download currency-exchange-service

Next TopicConfigure JPA and Initialized Data

Introduction to Currency Conversion and Currency Exchange Service

Introduction to Currency Conversion and Currency Exchange Service

Note: In this tutorial, we have quoted currency conversion service as a currency calculation service. Both the services have the same meaning, so don’t be confused.

Setting up a currency-exchange-service

Hardcoded the currency-exchange-service

Setting up Dynamic port in the Response

Note: Whatever value we are passing in the VM arguments, it overwrites the configuration of the application.properties file.

Accessibility testing

Best Book for Linux Operating System

You may also like