Dagger2系列教程目錄:
史上最適合新手的Dagger2教程(五)命名重虑、限定與延時(shí)加載
上節(jié)課的代碼中,我們遇到一個問題:使用@Inject注入每次都會new一個無參的新對象摩幔。
而在需要使用某一對象,或是單例的情況下羹呵,這個注入方式顯然是不可取的优构。
本節(jié)課就來講解Dagger2如何以單例模式注入對象琢融。
我們拿大名鼎鼎的OkHttp3為例,它的構(gòu)建方法是這樣的:
OkHttpClient okHttpClient = new OkHttpClient();
記得添加網(wǎng)絡(luò)權(quán)限:
<uses-permission android:name="android.permission.INTERNET"/>
用過OKHttp的都知道簿寂,這個實(shí)例在整個APP運(yùn)行過程中只要使用一個漾抬,多了會造成嚴(yán)重的性能損耗和大量的GC。
然而常遂,OkHttp的代碼不是自己寫的纳令,不能直接修改其源碼,因此肯定沒辦法像以往的注入方式一樣直接在構(gòu)建方法上使用@Inject。
這個時(shí)候平绩,就輪到模型(@Module)閃亮登場了~
1.建立模型(@Module)
模型(@Module)的作用就是在不修改對象源代碼的情況下圈匆,將其裝入注入器(@Component)。
我們現(xiàn)在就為OkHttp創(chuàng)建一個模型捏雌,使用@Module注解將它標(biāo)記起來:
@Module
public class OkHttpModule {
}
2.創(chuàng)建提供者(@Provides)
Provides跃赚,顧名思義——提供者,他用于給Dagger2標(biāo)記提供參數(shù)以及對象的方法性湿。
我們在上述模型中纬傲,創(chuàng)建一個提供對象的方法,并用@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ú)身的宵荒,這個注釋是用來標(biāo)記使用單例模式的提供者(Provides)以及注入器(Component):
@Module
public class OkHttpModule {
@Singleton//單例標(biāo)記
@Provides
public OkHttpClient okHttpClientProvider() {
return new OkHttpClient();
}
}
4.創(chuàng)建單例模型注入器(@Component)
這個注解是不是很熟悉~如果還不熟悉的話汁雷,請回顧第一節(jié)課!
這里的注入器和第一節(jié)的不同报咳,需要指定它的提供者模型(modules = OkHttpModule.class)侠讯,并標(biāo)記他是一個單例注入器(@Singleton):
@Singleton//注意:寫在Component的上面
@Component(modules = OkHttpModule.class)
public interface OkHttpComponent {
void inject(BaseApplication baseApplication);
}
需要注意的是,Singleton依附于Componment的生命周期少孝,如果你需要在整個APP中做一個單例继低,記得只能在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)確無誤啊徽曲!
告訴你零截,崩潰的原因是: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);
}
這個時(shí)候才有代碼。
我不知道這個是目前Dagger2的Bug得院,還是作者為了讓你“優(yōu)雅的編程”傻铣,故意這樣設(shè)計(jì)的,
總而言之祥绞,在寫注入器的時(shí)候非洲,一定要按強(qiáng)類型進(jìn)行注入!【畢竟幫不幫你注入是Dagger2說了算
那么關(guān)于Dagger2單例模式注入就到這里蜕径。