【Kotlin中使用Dagger2】基础入门篇(一)

【Kotlin中使用Dagger2】基础入门篇(一)

概述

Dagger2作为依赖注入神器,相信很多朋友都听说过它的大名。只不过它的有些概念,理解起来并不是那么清晰,并且在使用的过程中,也比较迷糊。我将把自身对Dagger2的理解、使用经验分享给大家,希望对大家有所帮助。我将分几节详细介绍Dagger2在Kotlin在如何使用,因为在Java中使用方式大同小异,所以大家理解了Dagger2,无论在Java还是Kotlin都能运用自如。

本节内容

这一小节,我们先简单介绍一下Dagger2的基本使用,主要包括:

  • Dagger2环境配置
  • 依赖注入(DI)
  • @Inject
  • @Component

Dagger2环境配置

首先,需要在Module中build.gradle引入插件(Java中使用apt,Kotlin使用kapt)

   apply plugin: 'kotlin-kapt'

接下来,引入依赖包和编译器

   compile "com.google.dagger:dagger:2.14.1"
    kapt "com.google.dagger:dagger-compiler:2.14.1"

依赖注入

大家记住一点, Dagger2是一个依赖注入框架 ,它能做的事就是完成依赖注入。那么什么是依赖注入。我们通过两段代码,直观的看一下。

第一种:传统方式,主动实例化

   lateinit var mPresenter:MainPresenter
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        mPresenter = MainPresenter()
    }

可以看到,成员变量mPresenter是通过构造方法直接实例化。

第二种:通过注解,注入实例化

   @Inject
    lateinit var mPresenter:MainPresenter
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
    }

可以看到,这次我们没有调用构造方法,而是在成员变量声明时,添加了一个注解@Inject,这样也能实例化成员变量mPresenter。后面大家会看,当调用mPresenter时,它并不为空,说明我们实例化是成功的。

这就是两种实例化方式,一种需要主动实例化,一种是被动接收,通过注解,自动实例化。

@Inject

在上面我们看到,注解@Inject能够实例化对象,那它到底是什么?

  • @Inject是Dagger2内置的一个注解;
  • @Inject用来标注目标对象(如上面的mPresenter);
  • @Inject用来标注依赖类的构造方法(如上面的MainPresenter);

上面三点,前两点都好理解,第三点“标注依赖类的构造方法”是什么意思,直接看代码:

   class MainPresenter @Inject constructor() {
        fun doSomething():String{
            return "This is result"
    }

可以看到,我们定义了一个类MainPresenter,在它的构造方法上添加了@Inject注解(由于有注解出现,显示无参构造器constructor),同时定义了一个方法doSomething,返回一个字符串。

为什么需要在MainPresenter构造方法上添加@Inejct,大家看下,mPresenter的类型是不是MainPresenter。这就告诉编译器,MainPresenter可通过Dagger2注入到目标类为MainPresenter类型的变量,通过构造方法实例化。

@Component

现在我们有@Inject标注的目标类,也有@Inject标注的依赖构造方法,那它们是不是就可以直接实例化了?答案是否定的,它们现在是独立的,并不知道对方的存在,如何将它们联系起来, 那就需要一个桥梁---Component,把依赖类连接到目标类。

首先,我们看一下Component如何声明

   @Component
    interface MainComponent {
        fun inject(activity:MainActivity)
    }

可以看到,我们定义了一个接口(必须是接口或抽象类),使用@Component进行标注,同时提供了一个方法inject。inject中的参数就是我们需要注入开始的类。

OK,现在我们桥梁Component也有了,如何让桥梁起作用。 编译一下,编译一下,编译一下 ,说三遍。编译完成后,会生成一个以“Dagger”开头的Component文件,如DaggerMainComponent,接下来咱们使用一下:

   class MainActivity : AppCompatActivity() {
        @Inject
        lateinit var mPresenter:MainPresenter
        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            setContentView(R.layout.activity_main)
            initInjection()
            mClickBtn.setOnClickListener {
                toast(mPresenter.doSomething())
            Dagger2注入注册