Understanding Dependency Injection - Real-World Examples and Advantages

Dependency injection is a design pattern that is widely used in software development to promote good software design and make code more flexible and easier to test. In this blog post, we will take a closer look at what dependency injection is, how it works, and its advantages.

What is Dependency Injection?

Dependency injection is a technique that allows an object to receive its dependencies (other objects it needs to function) from the outside, rather than creating them itself. This makes the code more flexible and easier to test, since the dependencies can be easily swapped out for different implementations.

Real World Example of Dependency Injection

Imagine you are building a shopping cart application for an e-commerce website. Your application has a class called "CartController" that handles all the logic for managing the shopping cart. This class needs to use another class called "PaymentService" to process payments.

If the "CartController" class creates the "PaymentService" class itself, it becomes hard to test or change the payment gateway. But if the "CartController" class receives the "PaymentService" class as a dependency, it is much easier to test and change. You can easily swap out the "PaymentService" class with a different implementation that uses a different payment gateway, such as PayPal or Stripe.

Another advantage is that when you want to add some feature in future, you can just add the feature in the PaymentService class and you don't need to touch the CartController class.

Dependency injection makes the code more flexible, easier to test, and easier to change in the future.

An example of how dependency injection could be implemented in Python using the "CartController" and "PaymentService" classes from the previous example:

 1class PaymentService:
 2    def __init__(self, gateway):
 3        self.gateway = gateway
 4
 5    def process_payment(self, amount):
 6        # code to process payment using the chosen gateway
 7        pass
 8
 9class CartController:
10    def __init__(self, payment_service):
11        self.payment_service = payment_service
12
13    def checkout(self, cart_items, amount):
14        # code to calculate total amount
15        self.payment_service.process_payment(amount)

In the above example, the "PaymentService" class takes the gateway as an input in the constructor, and the "CartController" class takes the payment_service as an input in the constructor. Here, the "CartController" class is dependent on "PaymentService" class, and it's not creating the object of PaymentService class inside it, rather it is getting it from outside.

To use these classes, we can create an instance of PaymentService class and pass it to the CartController class:

1gateway = "Paypal"
2payment_service = PaymentService(gateway)
3cart = CartController(payment_service)

This allows for easy testing and flexibility, as we can easily swap out the "PaymentService" class with a different implementation that uses a different payment gateway, such as Stripe or Authorize.net without changing the CartController class.

Another advantage is that when you want to add some feature in future, you can just add the feature in the PaymentService class and you don't need to touch the CartController class.

Advantages of Dependency Injection

Dependency injection has several advantages that make it an important technique for software development.

  1. Flexibility: Dependency injection makes code more flexible, since dependencies can be easily swapped out for different implementations.
  2. Testability: Dependency injection makes code easier to test, since dependencies can be easily mocked or stubbed out.
  3. Reusability: Dependency injection makes code more reusable, since dependencies can be shared across multiple classes.
  4. Loose Coupling: Dependency injection promotes loose coupling between classes, which makes code more maintainable and easier to understand.
  5. Easy to Add new Feature: Dependency injection makes it easy to add new features to the codebase. You can just add the feature in the service class and you don't need to touch the controller class.

Author: Sadman Kabir Soumik

Posts in this Series