用Dagger2在Android中實現依賴注入

用Dagger2在Android中實現依賴注入
依賴注入這個模式（模式已經用爛了，這裏再爛一次）是用來給應用的各部分解耦的。使應用開發更加可擴展，更容易維護。通過本文你會學到如何使用Dagger2來處理依賴。
簡介
如果以對象需要另外的一個對象才能完成一個完整功能的話，那麼這裏就存在一個依賴。比如，悟空要用金箍棒才能三打白骨精，要筋斗雲才能十萬八千里。悟空有對金箍棒和筋斗雲的依賴。你可以在悟空對象裏初始化金箍棒，也可以用一個工廠方法批量生產金箍棒。使用依賴注入可以無需一個專門的類來初始化這些依賴對象。這樣就實現了解耦。
本教程會使用最新的Dagger2（當前的版本是2.2）。這裏是官網。你可以在這裏找到最新的發佈。
準備
Android Studio是必須的。其他：
1. Dagger2 基礎
註解講解：
@Module這個annotation修飾的類專門用來提供依賴
@Provides這個annotation修飾的方法用在Module類裏
@Inject用來annotation一個依賴（可以是構造方法、field或者一般的方法）
@Component連接@Module和注入的橋樑
這些名詞看起來非常抽象。下面稍微解釋一下。依賴反射並沒有什麼神奇的地方。只不過是我們需要單獨寫初始化依賴的地方由其他的框架代替了。這個依賴關係也有我們常寫的代碼轉移到了“配置文件”中。
在很久以前，依賴注入的框架就是這樣處理依賴注入的：讀取配置文件的依賴關係，然後用反射的方法初始化被依賴對象並賦值給調用依賴的對象。比如，我們之前在悟空類中初始化金箍棒：
public class Wukong {
    private Jingubang jingubang;

    public Wukong(){
        // 依賴
        this.jingubang = Jingubang();
    }
}

後來有了使用配置文件的依賴注入（這裏都是虛構的文件格式）：
<xml>
    <com.xiyou.Wukong>
        <dependency field="jingubang">
            <com.xiyou.Jingubang />
        </dependency>
    </com.xiyou.Wukong>
</xml>

在悟空使用金箍棒的時候，依賴注入框架自動初始化好了金箍棒，並賦值給了悟空。
現在使用Dagger2。這裏就有不得不說的牛X的地方了。因爲是在Android裏能用的資源沒有後端那麼多。尤其反射消耗比較大！所以Dagger爲了滿足移動開發節約資源的需要，沒有使用反射實現依賴注入。而是在編譯的時候同時生成依賴注入的相關代碼。生成代碼的根據就是前文中說明的那些註解（annotation）以及使用這些annotation的類、接口。
總結起來就一句話，Dagger把你需要在悟空類裏寫的金箍棒類的初始化代碼都根據註解替你自動生成了！只不過這種生成的代碼比明晃晃的使用new初始化的方法更加複雜一些。
Dagger2 開發步驟
把大象裝冰箱一共分幾步：
定義依賴和被依賴的對象的類，悟空類和金箍棒類。“悟空類”和“金箍棒類”的構造函數用@Inject註解修飾。
定義一個@Module註解的類，一般叫做XXXModule。裏面寫的@Provides註解修飾的方法。這些@Provides方法返回“悟空類”和“金箍棒類”對象。比如@Provides Wukong provideWukong(){ return new Wukong(); }
創建一個interface，並用@Component註解修飾。一般叫做XXXComponent。裏面寫一個注入方法：void inject(Wukong wk);。這裏Wukong只是一個例子。任何你準備要注入的類都可以代替上面參數的Wukong類。
在需要注入的地方寫@Inject的field。
最後，Dagger會根據上面的內容和最後的@Component接口生成一個DaggerXXXComponent的類型，使用這個類型來實現注入。上面的1到3步可以理解爲依賴的配置。最後的XXXComponent代替古老的Reflect方式實現注入。
第一步的@Inject修飾的構造函數和`@Module`的`provideXXX`方法二者可以省略一個。
Dagger可以根據其中的任意一種配置創建依賴的對象。都寫上等於有了雙保險。

上文提到過多次。Dagger 2厲害的地方就在於這個庫完全不用反射，而是用在編譯期生成代碼的方式實現的依賴注入。這個特點導致在Android Studio配置的時候需要做一些額外的工作。
這裏假設你已經創建了一個新的Android應用項目。下面打開build.gradle文件，我們一步一步的來完成Dagger2的配置。
3. Android Studio的配置
第一步、
apply plugin: 'kotlin-android'             // 非必須
apply plugin: 'kotlin-android-extensions'  // 必須！！！

爲什麼要加一個新的plugin呢？這個是爲後面使用的kapt和provided提供支持的。gradle本身不支持這兩個操作。
第二步、
buildscript {
    ext.kotlin_version = '1.0.1-2'
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath "org.jetbrains.kotlin:kotlin-android-extensions:$kotlin_version"
    }
}

第三步、
dependencies {
    // ...其他略...
    compile 'com.google.dagger:dagger:2.2'
    kapt 'com.google.dagger:dagger-compiler:2.2'
    provided 'javax.annotation:jsr250-api:1.0'
}

dagger, 我們要用的正主。
dagger-compiler, 用來生成代碼。
java.annotation, 提供Dagger意外的註解
最後，同步Gradle。
使用Dagger 2
下面就是Dagger一展身手的時候了。
首先，我們已經有悟空和金箍棒了。代碼如下：
悟空：
import javax.inject.Inject;

/**
 * Created by uncle_charlie on 6/4/2016.
 */
public class Wukong {

    @Inject
    JinGuBang jinGuBang;

    @Inject
    public Wukong() {

    }

    public String useJinGuBang() {
        return this.jinGuBang.use();
    }
}

金箍棒：
import javax.inject.Inject;

/**
 * Created by uncle_charlie on 6/4/2016.
 */
public class JinGuBang {

    @Inject
    public JinGuBang() {

    }

    public String use() {
        return "user Jing gu bang";
    }
}

悟空對金箍棒有依賴，所以金箍棒屬性有@Inject註解修飾。
因爲兩個類都需要Dagger創建，所以在構造函數上都有@Inject註解。
第二步、創建@Module類
創建@Module註解的類，並在其中添加@Provides註解修飾的方法。這些方法創建被依賴的對象。
import dagger.Module;
import dagger.Provides;

/**
 * Created by uncle_charlie on 6/4/2016.
 */
@Module
public class XiYouModule {
    @Provides
//    @Singleton
    Wukong provideWukong() {
        return new Wukong();
    }

    @Provides
//    @Singleton
    JinGuBang provideJinGuBang() {
        return new JinGuBang();
    }
}

@Singleton註解表明，這個被依賴的對象在應用的生命週期裏只有一個實例。
這個裏的@Provides方法和前一步說到的@Inject註解的構造函數兩個可以只寫一個。
第三步、@Component接口，連接@Module和@Inject
@Module和@Provides方法提供了被依賴的對象。@Inject在@Component接口出現的地方則是指明瞭需要注入的地方（一般是一個field）。@Component接口就是用來把他們連接起來的。
import android.app.Activity;
import javax.inject.Singleton;
import dagger.Component;

/**
 * Created by uncle_charlie on 6/4/2016.
 */
@Component(modules = {XiYouModule.class})
@Singleton
public interface XiYouComponent {
    void inject(Wukong wk);
    void inject(Activity a);
}

其中inject()方法裏使用的對象，就是包含@Inject的field的需要注入的對象。
在這個接口中也可以不用inject()方法，而使用provideXXX()方法後面會有更多介紹。
注意：@Component接口一定要在直接中指明@Module類型

第四步、使用@Component接口獲取對象
經過前面的步驟，依賴和被依賴對象關係都已經配置好了。下面就來獲取被依賴對象來注入依賴對象。
public class MainActivity extends AppCompatActivity {
    private static final String TAG = "##MainActivity";

    @Inject
    Wukong wukong;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        TextView welcomeTextView = (TextView) findViewById(R.id.welcome_textview);
        // 1
        XiYouComponent xiYouComponent = DaggerXiYouComponent
                .builder()
                // 2
                .xiYouModule(new XiYouModule())
                .build();
        xiYouComponent.inject(this);
        // 3
        welcomeTextView.setText(wukong.useJinGuBang());
    }
}

首先主要到屬性@Inject Wukong wukong;已經在MainActivity聲明瞭。這裏表明一個依賴關係：這個activity依賴於悟空，並準備注入悟空對象。
Dagger2會在編譯器自動生成依賴注入的代碼，所以在添加上面的代碼之前需要編譯一下。DaggerXiYouComponent就是Dagger根據我們的XiYouModule類生成的代碼。
在這一步給DaggerXiYouComponent的builder添加XiYouModule的實例。如果這個Module只需要用到無參構造函數的話可以用一種省略用法：create()方法。可以簡寫爲：
DaggerXiYouComponent
            .builder()
            // 2
            //.xiYouModule(new XiYouModule())
            //.build()
            .create();

Component接口的對象調用inject(this)方法之後注入即完成。所以可以直接使用@Inject Wukong wukong;屬性來調用方法：welcomeTextView.setText(wukong.useJinGuBang());最後在activity中顯示方法返回的文字。
運行代碼，看看結果吧。
結論
以上內容可以概括爲：什麼被依賴，就把什麼放在@Module類裏（或者什麼被依賴，就給什麼添加@Inject的無參構造函數）。什麼有依賴（@Inject屬性），就把什麼放在@Component接口的inject()方法參數裏。（或者有什麼@Inject屬性，就在@Component接口裏provide什麼對象）。這個概括不一定嚴密，但是基本用法全部包括了。
依賴注入是很有用的。以上的內容只是Dagger2依賴注入的一部分。各位讀者還需要根據官方文檔多加練習才能更好的理解依賴注入和Dagger的各種用法。