Dagger2 Android依賴注入學習筆記
前言
最近在用 MVP + RxJava + Retrofit 寫項目,覺得相對于其他的開發(fā)框架,這的確是給我們帶來了很多方便,但是在網(wǎng)上搜尋相關(guān)資料的時候,總是能看到 MVP + RxJava + Retrofit + Dagger 這樣的搭配組合,那 Dagger 又是一個怎樣的框架呢,我也去具體搜了搜,但看到一些文章帶著“Dagger2從入門到放棄”這樣意思的句子,就感覺Dagger2會很難嗎,emmmm...行吧,好像是有點難理解,但是想著既然有那么多人用這個框架,必然有它的好處,于是花了些時間學習了一波。
Dagger2
Dagger2 : A fast dependency injector for Android and Java. (官方給出的定義)
Dagger2是一個依賴注解框架,它的作用就是通過注解來實現(xiàn)組件之間的依賴,由此來達到更好的解耦,比如說,如果將 Dagger2 使用到我們的 MVP 框架中,那么我們就可以達到 V層 和 P層 的進一步解耦,從而使我們的項目有更好的維護性。
Dagger2 和 Butterknife 一樣,都是在編譯階段利用Java注解通過APT(Annotation Processing Tool)自動生成Java代碼,然后由我們自己寫的代碼進行調(diào)用,完成依賴注入,因此不用擔心性能上的問題。那么如何來使用 Dagger2 呢?我們先來看一下使用 Dagger2 和不使用的區(qū)別。
對比
用簡單的例子來說明。比如說我們有這樣一個AAA類,沒什么內(nèi)容,只有一個get()方法
/** * @author chaochaowu * @Description : AAA * @class : AAA * @time Create at 6/12/2018 10:58 AM */ public class AAA { public AAA() { } public void get(){ Log.e("AAA","has gotten."); } }
我們需要在MainActivity用到這個類,因此MainActivity中變含有這個成員變量,有了這個成員變量aaa,我們就要對它進行實例化,因此會有以下的代碼:
/** * @author chaochaowu * @Description : MainActivity * @class : MainActivity * @time Create at 6/12/2018 10:58 AM */ public class MainActivity extends AppCompatActivity { AAA aaa; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); aaa = new AAA(); aaa.get(); } }
我們需要在 MainActivity 中聲明aaa這個變量,然后會對其進行new一個實例,然后才能對其進行調(diào)用,調(diào)用它定義的方法。這樣,AAA類對象的創(chuàng)建就和 MainActivity 耦合在了一起。如果使用 Dagger2 進行依賴注入呢
/** * @author chaochaowu * @Description : MainActivity * @class : MainActivity * @time Create at 6/12/2018 10:58 AM */ public class MainActivity extends AppCompatActivity { @Inject AAA aaa; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main2); DaggerMainActivityComponent.create().inject(this); aaa.get(); } }
代碼就會變成這樣。我們可以發(fā)現(xiàn)MainActivity里沒有任何有關(guān)aaa的初始化賦值,但是它還是可以調(diào)用其get()方法。這樣我們就達到了解耦合的目的。
這樣一個簡單的例子可能看不出 Dagger2 的好處,但是你可以想象一下,如果這個 Activity 里有很多個類似 AAA 這樣的類的成員變量,它們都需要初始化,有的初始化還要傳參數(shù),那么,這個 Activity 就會變得臃腫,如果 AAA類 的初始化參數(shù)變了,不僅 AAA類 需要改,MainActivity 因為它與AAA類的耦合也要跟著改變,如果 AAA類 不止用在 MainActivity 中還用在了其他的 Activity 中,那么要改的東西變的可有點多咯,但是如果用上Dagger2,我們就可以很好的解決這個問題。
注解介紹
Dagger2中注解有:@Inject, @Component, @Module, @Provides, @Qulifier, @Scope, @Singleten 。而我們主要用到的是@Inject, @Component,@Module, @Provides 這四個,下面來介紹一下。
@Inject
Inject 主要用來標記需要依賴的變量,告訴Dagger需要為它提供依賴;inject 還被用來標記類的構(gòu)造函數(shù)。當Dagger2碰到使用@Inject注解的變量時,會去尋找這個變量對應(yīng)的被@Inject注解的構(gòu)造函數(shù),把實例構(gòu)造出來,為變量提供依賴。
@Component
@Component用于標注接口,是依賴需求方(MainActivity)和依賴提供方(AAA)之間的橋梁。被Component標注的接口在編譯時會生成該接口的實現(xiàn)類,類的名稱為被@Component注解的類的名稱前加上Dagger,我們通過調(diào)用這個實現(xiàn)類的方法來完成注入。
@Module
Module用于標注提供依賴的類。雖然我們有@Inject注解實現(xiàn)注入,但是@Inject只能注入構(gòu)造函數(shù)為無參的類,要是構(gòu)造函數(shù)是帶參數(shù)的呢?那就要使用module注解來解決這個問題,又比如說,有很多的第三方庫,我們對它的代碼無法進行修改,也就不能對其構(gòu)造函數(shù)加上@Inject注解,那么可咋辦啊,@module注釋可以很好的解決我們的問題。
@Provides
Provides是與Module一起使用的,@Provides用于標注Module所標注的類中的方法,該方法會在需要提供依賴時被調(diào)用,在方法內(nèi)進行對象的初始化,返回對象依賴給標注了@Inject的變量。相當于一個有參數(shù)的@Inject。
我們來具體的使用一下。
構(gòu)造函數(shù)無參的對象注入
用上面提到的 AAA類 進行依賴注入演示。
首先我們在 AAA類 的構(gòu)造函數(shù)上加上 @Inject 注解(構(gòu)造函數(shù)必須得是無參)
/** * @author chaochaowu * @Description : AAA * @class : AAA * @time Create at 6/12/2018 10:58 AM */ public class AAA { @Inject public AAA() { } public void get(){ Log.e("AAA","has gotten."); } }
然后創(chuàng)建一個 MainActivityComponent 接口并用 @Component 進行注解,然后Build一下項目,
/** * @author chaochaowu * @Description : MainActivityComponent * @class : MainActivityComponent * @time Create at 6/12/2018 11:03 AM */ @Component public interface MainActivityComponent { void inject(MainActivity mainActivity); }
Build之后apt會自動生成如下的代碼
build后生成.png
我們利用其中的 DaggerMainActivityComponent 進行 MainActivity 與 AAA類 之間的橋梁搭建。如下代碼
/** * @author chaochaowu * @Description : MainActivity * @class : MainActivity * @time Create at 6/12/2018 10:58 AM */ public class MainActivity extends AppCompatActivity { @Inject AAA aaa; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main2); DaggerMainActivityComponent.create().inject(this); aaa.get(); } }
至此,我們便完成了構(gòu)造函數(shù)無參的對象的依賴注入。
構(gòu)造函數(shù)含參的對象注入
相信很多的時候,我們要用的對象在構(gòu)造的時候是需要參數(shù)的,那我們?nèi)绾芜M行它們的依賴注入呢,這里我用 MVP 中的 Presenter 來進行演示。
/** * @author chaochaowu * @Description : MainActivity * @class : MainActivity * @time Create at 6/12/2018 10:58 AM */ public class MainActivity extends AppCompatActivity implements MainContract.View{ MainContract.Presenter mPresenter; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); mPresenter = new MainPresenter(this); mPresenter.getData(); } }
上面的代碼是沒用 Dagger2 時的 Activity,在 MVP 框架中,由于 Presenter 需要與 View 進行交互,需要持有View的對象,因此在初始化的時候,需要在構(gòu)造函數(shù)里傳入View對象作為參數(shù),可以看到代碼中 mPresenter = new MainPresenter(this);
接下來我們對它進行依賴注入。首先看一下 Presenter,,Presenter不需要作出任何改變,我們可以看到它的構(gòu)造函數(shù)帶有一個參數(shù)View
/** * @author chaochaowu * @Description : MainPresenter * @class : MainPresenter * @time Create at 6/11/2018 2:22 PM */ public class MainPresenter implements MainContract.Presenter{ MainContract.View mView; public MainPresenter(MainContract.View mView) { this.mView = mView; } @Override public void getData() { } }
然后我們需要創(chuàng)建一個 MainActivityModule 類,并在該類名加上@Module注解,它含有一個成員變量 mView 需要在構(gòu)造函數(shù)時賦值,我們之后會將這個變量給 Presenter 進行 Presenter 的構(gòu)造,我們還需要寫一個方法,并在其上添加@Provides注解,方法的名字其實沒所謂可以隨便取,但是為了代碼的可讀性,一般都以provide開頭加上provide的東西的名字,我們在這個方法里返回我們所要提供依賴的對象,這里返回了一個 Presenter 對象,可以看到它在這里的構(gòu)造,我們傳入了參數(shù) View。到這便完成了MainActivityModule 的定義,其實這個 MainActivityModule 作用就和之前的 構(gòu)造函數(shù)無參中的 對無參構(gòu)造函數(shù) Inject 步驟的性質(zhì)相同。
/** * @author chaochaowu * @Description : MainActivityModule * @class : MainActivityModule * @time Create at 6/11/2018 2:41 PM */ @Module public class MainActivityModule { MainContract.View mView; public MainActivityModule(MainContract.View mView) { this.mView = mView; } @Provides public MainContract.Presenter providePresenter(){ return new MainPresenter(mView); } }
接下來和 構(gòu)造函數(shù)無參的對象注入 中一樣,我們需要定義一個 MainActivityComponent ,并用 @Component 進行注解,不一樣的是需要在括號里加上參數(shù) modules = {MainActivityModule.class} 如下代碼。
/** * @author chaochaowu * @Description : MainActivityComponent * @class : MainActivityComponent * @time Create at 6/11/2018 2:45 PM */ @Component(modules = {MainActivityModule.class}) public interface MainActivityComponent { void inject(MainActivity mainActivity); }
Build一下項目
build之后生成.png
這樣我們就可以像上面一樣,在Activity中調(diào)用DaggerMainActivityComponent 進行依賴注入。看一下Activity中的代碼。
/** * @author chaochaowu * @Description : MainActivity * @class : MainActivity * @time Create at 6/12/2018 10:58 AM */ public class MainActivity extends AppCompatActivity implements MainContract.View{ @Inject MainContract.Presenter mPresenter; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); DaggerMainActivityComponent.builder() .mainActivityModule(new MainActivityModule(this)) .build() .inject(this); mPresenter.getData(); } }
可以看到這里 DaggerMainActivityComponent 調(diào)用的方法有所不同,其中調(diào)用了一個mainActivityModule() 方法,傳入了一個 MainActivityModule 對象,該對象的初始化,我們又傳入了一個this,也就是View,這個 View就是我們在之后創(chuàng)建 Presenter 時傳入的參數(shù) 。
至此,我們就完成了構(gòu)造函數(shù)有參的對象的依賴注入。其他有參的、第三方庫的依賴注入也是通過這樣的方式進行。
總結(jié)
Dagger2的使用,讓我們代碼的耦合度進一步降低了,這是一個優(yōu)點,但是另一方面,使用了Dagger2你需要額外的去定義一些類,導(dǎo)致代碼的數(shù)量也增加。個人覺得,在比較小的項目中,如果去使用,有點emmmm....多此一舉?(劃掉),但是如果一個項目比較大,代碼本身也比較多,那么使用Dagger2所帶來的優(yōu)點,便可以顯現(xiàn)了。所以說,是否在項目中使用 Dagger2 仁者見仁智者見智,不過作為一個學習的點,還是挺不錯的,嗯。
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
Android開源項目PullToRefresh下拉刷新功能詳解
這篇文章主要為大家詳細介紹了Android開源項目PullToRefresh下拉刷新功能,具有一定的參考價值,感興趣的小伙伴們可以參考一下2016-09-09Android賬號注冊實現(xiàn)點擊獲取驗證碼倒計時效果
這篇文章主要為大家詳細介紹了Android賬號注冊過程中實現(xiàn)點擊獲取驗證碼倒計時效果,具有一定的參考價值,感興趣的小伙伴們可以參考一下2016-05-05Android開發(fā)Jetpack組件ViewModel與LiveData使用講解
Jetpack是一個由多個技術(shù)庫組成的套件,可幫助開發(fā)者遵循最佳做法,減少樣板代碼并編寫可在各種Android版本和設(shè)備中一致運行的代碼,讓開發(fā)者精力集中編寫重要的代碼2022-09-09Android使用AutoCompleteTextView實現(xiàn)自動填充功能的案例
今天小編就為大家分享一篇關(guān)于Android使用AutoCompleteTextView實現(xiàn)自動填充功能的案例,小編覺得內(nèi)容挺不錯的,現(xiàn)在分享給大家,具有很好的參考價值,需要的朋友一起跟隨小編來看看吧2019-03-03詳解Android中Service服務(wù)的基礎(chǔ)知識及編寫方法
這篇文章主要介紹了詳解Android中Service服務(wù)的基礎(chǔ)知識及編寫方法,包括Service的啟動流程及生命周期等基本內(nèi)容,需要的朋友可以參考下2016-04-04Android編程實現(xiàn)使用Intent傳輸包含自定義類的ArrayList示例
這篇文章主要介紹了Android編程實現(xiàn)使用Intent傳輸包含自定義類的ArrayList,涉及Android對象序列化、反序列化、Intent數(shù)據(jù)傳輸?shù)认嚓P(guān)操作技巧,需要的朋友可以參考下2017-08-08Android開發(fā)之圖片壓縮實現(xiàn)方法分析
這篇文章主要介紹了Android開發(fā)之圖片壓縮實現(xiàn)方法,結(jié)合實例形式分析了Android圖片壓縮的原理、實現(xiàn)方法及相關(guān)操作注意事項,需要的朋友可以參考下2019-03-03