September 2023 – Marko Medojević

Suppose that you have a webshop with a credit card payment option. Credit card payments work fine in a production environment. There is a new requirement to implement a sandbox environment for the webshop. Sandbox environment doesn’t charge your credit card. It always returns a successful response.

Each checkout implementation is based on the following CheckoutService interface:

public interface CheckoutService {
    public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber);
}

public interface CheckoutService {

public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber);

}

The implementation of CheckoutService an interface for the production environment is BankCheckoutService

@Service
public class BankCheckoutService implements CheckoutService {
    @Override
    public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber) {
        System.out.println("charge credit card using real payment gateway");
        return true;
    }
}

@Service

public class BankCheckoutService implements CheckoutService {

@Override

public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber) {

System.out.println("charge credit card using real payment gateway");

return true;

}

CheckoutController gets instance of CheckoutService using @Autowired annotation (dependency injection).

@RestController
public class CheckoutController {
    private final CheckoutService checkoutService;

    @Autowired
    public CheckoutController(CheckoutService checkoutService) {
        this.checkoutService = checkoutService;
    }

    @GetMapping("/checkout")
    public ResponseEntity&lt;Boolean&gt; checkout() {
        Integer orderId = 12377;
        BigDecimal amount = new BigDecimal(20000.50);
        String creditCardNumber = "4111111111111111";
        boolean success = checkoutService.checkout(orderId, amount, creditCardNumber);
        return ResponseEntity.ok(success);
    }
}

@RestController

public class CheckoutController {

private final CheckoutService checkoutService;

@Autowired

public CheckoutController(CheckoutService checkoutService) {

this.checkoutService = checkoutService;

}

@GetMapping("/checkout")

public ResponseEntity<Boolean> checkout() {

Integer orderId = 12377;

BigDecimal amount = new BigDecimal(20000.50);

String creditCardNumber = "4111111111111111";

boolean success = checkoutService.checkout(orderId, amount, creditCardNumber);

return ResponseEntity.ok(success);

}

Let us create a new implementation of CheckoutService interface for the sandbox environment:

@Service
public class SandboxCheckoutService implements CheckoutService {
    @Override
    public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber) {
        System.out.println("don't charge credit card, always return successful response");
        return true;
    }
}

@Service

public class SandboxCheckoutService implements CheckoutService {

@Override

public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber) {

System.out.println("don't charge credit card, always return successful response");

return true;

}

It will work fine if we replace a constructor of CheckoutController to get SandboxCheckoutService bean:

@Autowired
public CheckoutController(SandboxCheckoutService checkoutService) 
    this.checkoutService = checkoutService;   
}

@Autowired

public CheckoutController(SandboxCheckoutService checkoutService)

this.checkoutService = checkoutService;

}

However, we want to instantiate either BankCheckoutService or SandboxCheckoutService based on the variable in the application properties file. SandboxCheckoutService should be instantiated if application properties contains the following content:

sandbox=true

1	sandbox=true

If sandbox the variable is false BankCheckoutService will be instantiated.

Spring Boot already has a solution. @ConditionalOnProperty annotation provides us the possibility to conditionally instantiate bean based on property value from application.properties file.

BankCheckoutService:

@Service
@ConditionalOnProperty(name = "sandbox", havingValue = "false")
public class BankCheckoutService implements CheckoutService {
    @Override
    public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber) {
        System.out.println("charge credit card using real payment gateway");
        return true;
    }
}

@Service

@ConditionalOnProperty(name = "sandbox", havingValue = "false")

public class BankCheckoutService implements CheckoutService {

@Override

public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber) {

System.out.println("charge credit card using real payment gateway");

return true;

}

SandboxCheckoutService

@Service
@ConditionalOnProperty(name = "sandbox", havingValue = "true")
public class SandboxCheckoutService implements CheckoutService {
    @Override
    public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber) {
        System.out.println("don't charge credit card, always return successful response");
        return true;
    }
}

@Service

@ConditionalOnProperty(name = "sandbox", havingValue = "true")

public class SandboxCheckoutService implements CheckoutService {

@Override

public boolean checkout(Integer orderId, BigDecimal amount, String creditCardNumber) {

System.out.println("don't charge credit card, always return successful response");

return true;

}

The controller doesn’t have to be changed since it expects CheckoutService interface which is implemented in both BankCheckoutService and SandboxCheckoutService. Controller depends on abstraction not implementation as it is specified in SOLID principle.

We can now switch between BankCheckoutService and SandboxCheckoutService by changing the sandbox variable in the application.properties file.

id	title	parent_id
1	CEO	NULL
2	Director 1	1
3	Director 2	1
4	Manager 1	2
5	Manager 2	2
6	Manager 3	3
7	Manager 4	3
8	OP 1	4
9	OP 2	4
10	OP 3	5
11	OP 4	5
12	OP 5	6
13	OP 6	6
14	OP 7	7
15	OP 8	7

Month: September 2023

MariaDB recursive query

Spring boot dependency injection using @ConditionalOnProperty annotation