Dependency Injection With Dagger 2 on Android

Dependency Injection With Dagger 2 on Android

Dependency injection is a software design pattern focused on making our applications loosely coupled, extensible, and maintainable. In this tutorial, you will learn how to handle dependency injection using Dagger 2.

Introduction

When you have an object that needs or depends on another object to do its work, you have a dependency. Dependencies can be solved by letting the dependent object create the dependency or asking a factory object to make one. In the context of dependency injection, however, the dependencies are supplied to the class that needs the dependency to avoid the need for the class itself to create them. This way you create software that is loosely coupled and highly maintainable.

This tutorial uses the newest version of Dagger, Dagger 2. At the time of writing, Dagger 2 isn't officially released yet and is in pre-alpha stage. However, it is usable and stable. You can visit Dagger on GitHub to get news about the project and possible dates for the official release.

Prerequisites

You will need the latest version of Android Studio installed on your development machine, which you can download from the Android Developer website.

1. Dagger 2 API

Dagger 2 exposes a number of special annotations:

  • @Module for
    the classes whose methods provide dependencies
  • @Provides for the methods
    within @Module classes
  • @Inject to request a dependency (a constructor, a
    field, or a method)
  • @Component is a bridge interface between modules and injection

These
are the most important annotations you need to know about to get
started with dependency injection using Dagger 2. I'm going to show you
how to
use them in a simple Android application.

2. Dagger 2 Workflow

To implement Dagger 2 correctly, you have to follow these steps:

  1. Identify the dependent objects and its dependencies.
  2. Create a class with the @Module annotation, using the @Provides annotation for every method that returns a dependency.
  3. Request dependencies in your dependent objects using the @Inject annotation.
  4. Create an interface using the @Component annotation and add the classes with the @Module annotation created in the second step.
  5. Create an object of the @Component interface to instantiate the dependent object with its dependencies.

Dependency analysis is shifted from run time to compile time. This means
that you are notified of possible problems during the development
phase, unlike with other libraries, such as Guice. Before using the Dagger 2 library, you need to prepare your Android Studio installation to access the generated classes.

3. Android Studio Environment Setup

Step 1

Create a new application using Android Studio and give it a name. I've named my project TutsplusDagger.

Step 1 Type a name for the project

Step 2

Set the Minimum SDK for the project to API 10 to reach as many devices as possible.

Step 2 Select minimum SDK

Step 3

Choose the Blank layout for the activity you are creating. For this tutorial, you don't need a special layout.

Step 3 Choose the template for the project

Step 4

Name the activity MainActivity and click Finish.

Step 4 Type a name for the activity

With  the project created, you need to make a few modifications to the gradle
files. Let's make those changes in the next step.

4. Configuring Gradle Setup

Step 1

We need to modify the project's build.gradle file as shown below.

Let's take a moment to see what changes we've made:

  • dependencies: In this section, I've added a plugin that is going to be useful for accessing the code generated by
    Dagger. If you don't, you'll see errors when referring to these new classes.
  • allprojects: This
    change is necessary since the libraries we're going to use are
    currently in pre-alpha, and this is the only place available if you want
    to access them
    using Maven. You can try to download the Dagger and Dagger Compiler libraries from Sonatype, but this tutorial is based on the Maven
    repositories.

Step 2

Open build.gradle in your project's app folder and modify it as shown below.

At the beginning of the file, I'm applying the new plugin. Be
sure to put the new plugin (com.neenbedankt.android-apt) below or after the Android plugin. If you don't, then it's going to show errors when trying to
synchronize the project with the gradle files.

In dependencies I added:

  • dagger library
  • dagger-compiler for code generation
  • javax.annotation for additional annotations required outside Dagger

After updating Dagger's configuration, you can synchronize the project with
the gradle files by clicking the button at the top.

Synchronize project with grade files

At
this point, you have an empty project ready to be used in your
application. If you see any errors, make sure you've correctly followed the above steps. We can now proceed to implement our example project.

5. Implementing Dagger 2

Step 1: Identify Dependent Objects

For this tutorial, I'm going to work with two classes, Vehicle and Motor. Motor is the independent class and Vehicle is the dependent class. I'm going to start creating this model within a new package called model.

This is what the Motor class look like:

This class has only one attribute called rpm, which I'm going to modify through the accelerate and brake methods. And I'll check the current value using the getRpm method.

This is what the Vehicle class looks like:

In this class, you can see that I'm not creating a new object of the Motor class, even though I'm using its methods. In a real world application, this class should have more methods and attributes, but let's keep it simple for now.

Step 2: Create @Module Class

You now have to create a class with the @Module
annotation. This class is going to provide the objects you will need with its dependencies satisfied. For this, you have to create a new package (just to keep it in order), name it module and add a new class inside it as follows:

As I specified in Step 1, Vehicle needs
Motor to work properly. That is why you need to create two
providers, one for Motor (the independent model) and another one for Vehicle
(indicating its dependency).

Don't forget that every provider (or method) must have the
@Provides annotation and the class must have the @Module annotation.
The @Singleton annotation indicates that there will be only one
instance of the object.

Step 3: Request Dependencies in Dependent Objects

Now that you have the providers for your different models, you need to
request them. Just as Vehicle needs Motor, you have to add the @Inject annotation in the Vehicle constructor as follows:

You
can use the @Inject annotation to request dependencies in the constructor, fields, or methods. In this case, I'm keeping the
injection in the constructor.

Step 4: Connecting
@Modules With @Inject

The connection between the provider of dependencies, @Module, and the
classes requesting them through @Inject is made using @Component,
which is an interface:

Next to the @Component annotation, you have to specify which modules are going to be used—in this case
I use VehicleModule, which we created earlier. If you need to use more modules, then just add them using a comma as a separator.

Within the interface, add methods for every object you need and it will automatically give
you one with all its dependencies satisfied. In this case, I only need a
Vehicle object, which is why there is only one method.

Step 5: Using @Component Interface to Obtain Objects

Now that you have every connection ready, you have to obtain an
instance of this interface and invoke its methods to obtain the
object you need. I'm going to implement it in the onCreate method in the MainActivity as follows:

When you try to create a new object of the interface with the @Component annotation, you have to do it using the prefix Dagger_<NameOfTheComponentInterface>, in this case Dagger_VehicleComponent, and then use the builder method to call every module within.

You can see that the magic takes place on line 23. You are only asking for one object of the class Vehicle and
the library is the one in charge of satisfying all the dependencies this
object needs. Again you can see there is no new instantiation of any
other object—everything is managed by the library.

You can now run the app and try it on your device or in an emulator. If you
followed the tutorial step by step, you will see a Toast message indicating the initial value or the rpm variable.

In the attached project, you can see a custom user interface for the MainActivity class, in which you can modify the value of the rpm variable by tapping the buttons on the screen.

Conclusion

Dependency injection is a pattern that you will have to implement
sooner or later in your own applications. With Dagger 2, you
have an easy-to-use library to implement it. I hope you found this
tutorial useful, and don't forget to share it if you liked it.

Source: Tuts Plus

About the Author

Comments

  1. … [Trackback]

    […] There you will find 36790 more Infos: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  2. … [Trackback]

    […] Read More Infos here: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  3. … [Trackback]

    […] Read More: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  4. … [Trackback]

    […] Informations on that Topic: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  5. … [Trackback]

    […] Informations on that Topic: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  6. … [Trackback]

    […] Find More Informations here: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  7. … [Trackback]

    […] Read More: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  8. … [Trackback]

    […] Read More here: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  9. … [Trackback]

    […] Informations on that Topic: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  10. … [Trackback]

    […] Informations on that Topic: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  11. … [Trackback]

    […] Read More Infos here: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  12. … [Trackback]

    […] Informations on that Topic: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  13. ppc blog says:

    … [Trackback]

    […] Read More: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  14. … [Trackback]

    […] There you will find 91367 more Infos: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  15. … [Trackback]

    […] Read More: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  16. … [Trackback]

    […] Read More here: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  17. … [Trackback]

    […] Informations on that Topic: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  18. … [Trackback]

    […] Find More Informations here: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  19. … [Trackback]

    […] Read More: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  20. … [Trackback]

    […] Informations on that Topic: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  21. … [Trackback]

    […] There you will find 36496 more Infos: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  22. … [Trackback]

    […] Read More here: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  23. … [Trackback]

    […] Find More Informations here: designncode.in/dependency-injection-with-dagger-2-on-android/ […]

  24. … [Trackback]

    […] Find More Informations here: designncode.in/dependency-injection-with-dagger-2-on-android/ […]