Dagger2系列教程目錄:
史上最適合新手的Dagger2教程(五)命名、限定與延時(shí)加載
上節(jié)課的代碼中,我們遇到一個(gè)問題:使用@Inject注入每次都會(huì)new一個(gè)無參的新對象。
而在需要使用某一對象,或是單例的情況下,這個(gè)注入方式顯然是不可取的。
本節(jié)課就來講解Dagger2如何以單例模式注入對象。
我們拿大名鼎鼎的OkHttp3為例,它的構(gòu)建方法是這樣的:
OkHttpClient okHttpClient = new OkHttpClient();
記得添加網(wǎng)絡(luò)權(quán)限:
<uses-permission android:name="android.permission.INTERNET"/>
用過OKHttp的都知道,這個(gè)實(shí)例在整個(gè)APP運(yùn)行過程中只要使用一個(gè),多了會(huì)造成嚴(yán)重的性能損耗和大量的GC。
然而,OkHttp的代碼不是自己寫的,不能直接修改其源碼,因此肯定沒辦法像以往的注入方式一樣直接在構(gòu)建方法上使用@Inject。
這個(gè)時(shí)候,就輪到模型(@Module)閃亮登場了~

1.建立模型(@Module)
模型(@Module)的作用就是在不修改對象源代碼的情況下,將其裝入注入器(@Component)。
我們現(xiàn)在就為OkHttp創(chuàng)建一個(gè)模型,使用@Module注解將它標(biāo)記起來:
@Module
public class OkHttpModule {
}
2.創(chuàng)建提供者(@Provides)
Provides,顧名思義——提供者,他用于給Dagger2標(biāo)記提供參數(shù)以及對象的方法。
我們在上述模型中,創(chuàng)建一個(gè)提供對象的方法,并用@Provides標(biāo)記起來:
@Module
public class OkHttpModule {
@Provides
public OkHttpClient okHttpClientProvider() {
return new OkHttpClient();
}
}
3.單例標(biāo)記(@Singleton)
因?yàn)镺kHttp的實(shí)例需要用到單例模式,這里就輪到@Singleton登場了,
Singleton,翻譯過來就是獨(dú)身的,這個(gè)注釋是用來標(biāo)記使用單例模式的提供者(Provides)以及注入器(Component):
@Module
public class OkHttpModule {
@Singleton//單例標(biāo)記
@Provides
public OkHttpClient okHttpClientProvider() {
return new OkHttpClient();
}
}
4.創(chuàng)建單例模型注入器(@Component)
這個(gè)注解是不是很熟悉~如果還不熟悉的話,請回顧第一節(jié)課!
這里的注入器和第一節(jié)的不同,需要指定它的提供者模型(modules = OkHttpModule.class),并標(biāo)記他是一個(gè)單例注入器(@Singleton):
@Singleton//注意:寫在Component的上面
@Component(modules = OkHttpModule.class)
public interface OkHttpComponent {
void inject(BaseApplication baseApplication);
}
需要注意的是,Singleton依附于Componment的生命周期,如果你需要在整個(gè)APP中做一個(gè)單例,記得只能在Application中inject()!切記!切記!切記!
5.構(gòu)建項(xiàng)目,生成注入器
Make一下Project,喝口冰闊落。

6.使用模型注入器
不帶參數(shù)的對象,注入器使用起來是一模一樣的,都是DaggerXXXComponent.create().inject(this);
public class BaseApplication extends Application {
@Inject
OkHttpClient okHttpClient;
@Override
public void onCreate() {
super.onCreate();
//注入對象
DaggerOkHttpComponent.create().inject(this);
/**
以下為OkHttp使用,與Dagger2無關(guān)
*/
Request request = new Request.Builder().url("https://www.baidu.com/s?wd=世界上最帥的人").build();
okHttpClient.newCall(request).enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.e("result", "查無此人");
}
@Override
public void onResponse(Call call, final Response response) throws IOException {
Log.e("result", response.body().string());
}
});
}
}
這樣一來,就以Dagger2的方式創(chuàng)建了單例OkHttpClient。
那么話說回來,如果不需要單例模式怎么辦呢?
如果不需要單例模式,去掉注入器和提供者上的@Singleton注釋就好了~
7.踏坑
有些同學(xué)就要問了,那在注入的時(shí)候,直接注入Activity豈不是復(fù)用性更高嗎~
@Singleton
@Component(modules = OkHttpModule.class)
public interface OkHttpComponent {
//這里直接注入Activity
void inject(Activity activity);
}
那我們現(xiàn)在就開始以這種方式踏坑~


啥玩意兒啊,我明明@Inject了啊,所有代碼都準(zhǔn)確無誤?。?/p>
告訴你,崩潰的原因是:Dagger2是強(qiáng)類型注入的。
我們來看下當(dāng)你使用Activity注入時(shí),Dagger2生成的代碼:
public final class DaggerOkHttpComponent implements OkHttpComponent {
......
@Override
public void inject(Activity activity) {}
看到?jīng)],inject方法是空的!空的!空的!
而使用MainActivity注入時(shí):
public final class DaggerOkHttpComponent implements OkHttpComponent {
......
@Override
public void inject(MainActivity mainActivity) {
injectMainActivity(mainActivity);
}
這個(gè)時(shí)候才有代碼。
我不知道這個(gè)是目前Dagger2的Bug,還是作者為了讓你“優(yōu)雅的編程”,故意這樣設(shè)計(jì)的,
總而言之,在寫注入器的時(shí)候,一定要按強(qiáng)類型進(jìn)行注入!【畢竟幫不幫你注入是Dagger2說了算

那么關(guān)于Dagger2單例模式注入就到這里。