更加强大的Dagger2

发表于 5年以前  | 总阅读数:2048 次

更加强大的Dagger2

著名的依赖注入库Dagger的2.0版本变为生产版本只是一个时间问题,这似乎给了我一个写一篇关于它的文章的好理由。

Dagger 1

在这里,先做一个小小的历史回顾,Dagger是由Square公司的几个十分优秀的开发人员在2012年创建的,他们觉得将依赖注入应用到Java中是一个非常棒的点子,但是却觉得当时使用的Guice库(当时的标准)的速度稍微有点慢。所以,他们开发了一个依赖于基于注解的代码生成(JSR-330),拥有着和Guice相似的API,但是性能更强、更加灵活的库。

Dagger的工作原理就是通过声明一些module,这些module里包括了所有你想要注入的依赖的提供者方法(provider method), 把这些module加载到一个对象图谱(object graph)里,最终将图谱中的内容根据需要注入到对象(target)中。 足够简单的结构(当然实现起来还是不那么简单的)有利于开发者解耦他们的代码,并且通过把初始化代码移动到由库自动生成的injector中,从而删掉每个类开始的地方那些丑陋的工厂类初始化代码。

然而,伴随着明显的优点(这些优点足以让大部分的Android开发者选择Dagger作为他们开发新项目中选择使用的第一个库),也存在着一些明显的问题,都是一些不可以简单地被一个或者两个的pull request就解决掉的问题,因为这些问题都是与整个底层架构相关的。

  • 图谱(Graph)是在运行时构建的 -影响性能,尤其是在频繁请求的用例中(后台服务器场景),

  • 使用了反射(比如说 用Class.forName()来获取已经生成的类型) - 使得生成的代码难以跟踪,同时ProGuard配置文件的编写成了噩梦

  • 生成的代码不美观 -特别是与那些人手写的工厂类初始化方法相比较时,这一点尤其明显。

因而,在Github的问题跟踪系统中,由于上述问题导致的一些issues,都被标记为“它就是这样的,这个问题会在Dagger2中解决”

Dagger 2

时间快进到现在,Google的core libraries团队(Guava的创造者)与原来的Square的创建者一起推出了新一代的Dagger,并在一个月内就发布了生产版本

新的release版本,像之前所承诺的一样,解决了老版本的许多问题:

  • 不再使用反射 所有东西都是通过明确的方法调用来完成的(不需要配置ProGuard文件就可以正常混淆)

  • 不再在运行时构建图表(graph) - 提高了性能,包括在单请求(per-request)用例中(据Gregory Kick说,在谷歌的搜索产品中,它的表现比以前快了13%)

  • 可追溯的 - 生成的代码更优雅,同时没有使用到反射,使得代码可读性提高,并且容易跟踪

Usage 用法

虽然Dagger也可以用在任何的Java工程中,但是在示例代码中,我们将专注于它在Android平台上的应用。不过,这些代码都可以很容易的就被改写,以用于其它地方,比如说,改写为服务器后端相关的代码。

Module

Dagger2中基本保持不变的部分是module。你仍然需要在这里定义可被注入的依赖的提供者方法(provider methods)。比如说,我们需要注入的是SharedPreferences对象。

@Module
public class ApplicationModule {  
private Application mApp;

public ApplicationModule(Application app) {
mApp = app;
}

@Provides 
@Singleton
SharedPreferences provideSharedPrefs() {
return PreferenceManager.getDefaultSharedPreferences(mApp);
}
}

类似的,你可以提供(provide)其他的东西(并不是所有的,只是提供一些想法)

  • Context
  • System services (e.g. LocationManager)
  • REST service (e.g. Retrofit)
  • Database manager (e.g. Realm)
  • Message passing (e.g. EventBus)
  • Analytics tracker (e.g. Google Analytics)

Component

眼尖的读者可能发现了在@Module注解中,injects = {}参数不见了,那是因为Dagger2不再需要用到这个参数了。取而代之的是,"component"的概念,component是用来连接module和要注入依赖的对象(target)之间的桥梁。

@Singleton
@Component(modules = {ApplicationModule.class})
public interface ApplicationComponent {  
void inject(DemoApplication app);
void inject(MainActivity activity);
}

所以,你仍然需要注明(define)你要注入依赖的对象(target),但是,与之前不同的是,如果你现在不注明的话,在编译时就会提示"cannot find method"错误,而这个错误在以前,则是一个隐秘的运行时错误,只有在运行时才会报错。

Application 应用

下一步,我们要了解的是你的component的容器。具体的方式由你的应用来决定,你可以选择用更复杂的方式保存你的components,但是对于这个例子来说,一个简单的保存在application中的component就足以说明情况了。

public class DemoApplication extends Application {  
private ApplicationComponent mComponent;

@Override 
public void onCreate() {
super.onCreate();
mComponent = DaggerApplicationComponent.builder()
.applicationModule(new ApplicationModule(this))
.build();
}

public ApplicationComponent getComponent() { 
return mComponent;
}
}

这里没有什么新的东西:只是之前我们创建并初始化的的是对象图谱(ObjectGraph),而现在,我们则会创建并初始化对应的component。

注意:你很有可能会在某个时候想到这个问题,我在这先提前解释一下。上面例子中的DaggerApplicationComponent是一个编译时生成的类(命名方式是 Dagger%COMPONENT_NAME%),只要你对你的component做了改动,就需要重新编译工程,通过了,这个类才会被生成。所以,如果你找不到这个类,点击你的IDE的"Rebuild Project",如果编译不出错的话,它就会出现了。类似的,applicationModule()方法对应于你的module的名字。

Injection 注入

终于,经过前面几个部分为注入进行的准备后,我们来到了用到它们的地方了,我们要在activity中注入一个SharedPreferences对象。

public class MainActivity extends Activity {  
@Inject SharedPreferences mSharedPrefs;

@Override 
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
((DemoApplication) getApplication()).getComponent().inject(this);

mSharedPrefs.edit().putString(“status”, “success!”).apply();
}
}

和期待的一样,@Inject注解的使用没有任何改变,只是注入本身发生了一点变化。

这里有一点小小的不便,是由于inject()方法是强类型关联的,这个我们在后面会讨论到。

Named injections 命名注入 如果你有几个对象是同一类型的,比如说两个不同的SharedPreferences实例(可能是指向了不同的文件),这时候,我们可以怎么做? 这时候,我们就需要用到命名注入了。只要在module的提供者(provider)里像下面一样使用@Named注解

@Provides 
@Named(“default”) 
SharedPreferences provideDefaultSharedPrefs() { … }

@Provides 
@Named(“secret”)
SharedPreferences provideSecretSharedPrefs() { … }  

在要注入的对象中,注入的方法是一样的

@Inject @Named(“default”) SharedPreferences mDefaultSharedPrefs;
@Inject @Named(“secret”) SharedPreferences mSecretSharedPrefs;

很简单,没有什么好解释的,但是这是一个非常有用的用法,值得一提。

Lazy injections 延迟注入

说到性能,如果在一个要注入依赖的对象中,有很多不同的依赖需要被注入,有些依赖只会在某些特定的场景才会被用到(比如说 用户输入的时候)。在这种情况下,如果我们没有用到这个依赖,也要去注入的话,会导致资源的浪费,所以,我们可以选择用延迟注入(lazy injection)替代。

@Inject Lazy<SharedPreferences> mLazySharedPrefs;

void onSaveBtnClicked() {  
mLazySharedPrefs.get()
.edit().putString(“status”, “lazy…”)
.apply();
}

这里的意思是说,mLazySharedPrefs只有在第一次调用get()方法的时候才会被注入。之后所有的get()调用都会是同一个mLazySharedPrefs实例。

Provider injections 注入提供者

最后一个诀窍,如果你是在一个全新的你可以完全掌控住的工程中,你想要实现这样的注入的话,你可能会考虑用其它方法来替代,比如说工厂方法。 但是,对于历史遗留代码来说,这个诀窍将会很有用。

想象这样一个场景,你需要创建一个对象的多个实例,而不是仅仅注入单个实例。在这时候,你需要注入一个提供者(Provider<T>

@Inject Provider<Entry> mEntryProvider;

Entry entry1 = mEntryProvider.get();  
Entry entry2 = mEntryProvider.get();  

在这个例子中,你的提供者(provider)会创建两个Entry对象的实例。有一点要注意的是,module中的实例如何创建完全是由你决定的

Annoyances 烦人的地方

还好,我真的不能把这个部分叫做问题,因为都是一些不足以称为问题的东西。

烦人的地方#1: 像是之前提到的,inject()方法与要注入的target,是强类型关联的。这对于debug来说很好,但是这对于我们希望在基类中实现注入的普遍做法变得复杂(如在 base activity,fragment等中)。

直觉上,你觉得应该在基类中创建一个inject()方法,但是,这样做的话,它就仅仅会注入那些在基类中声明的依赖,在他的子类中声明的依赖并不会被注入。

解决方法1:这也是我所使用的解决方案,就是在基类中声明一个抽象的注入方法来进行实际上的注入

@Override
public void onCreate(Bundle savedInstanceState) {  
super.onCreate(savedInstanceState);
injectComponent(((DemoApplication) getApplication()).getComponent());
}

protected void injectComponent(ApplicationComponent component);  

然后在你的子类中实现这个方法


@Override
protected void injectComponent(ApplicationComponent component) {  
component.inject(this);
}

与Dagger1相比,需要多写一个额外的方法,来实现同样的事情。但是为了可以在编译时查错,这个代价是完全值得的。

解决方法2:另一个选择就是利用反射。如果你看到反射就不想看下去的话,并不怪你:因为这也是Dagger2所提到的点,不利用反射。但是,如果你坚持要在基类中实现注入,而不想在子类中增加额外方法的话,请继续往下看。

这个解决方法简而言之就是要找到你要注入的类型所对应的inject()方法。

首先,你要将在component类中声明的所有方法对应上方法的参数类型来保存在缓存中(因为inject()方法只能有一个参数,所以只需保存第一个有一个参数的方法就行)

// Keep the returned cache in some helper.
Map<Class, Method> buildCache() {  
Map<Class, Method> cache = new HashMap<>();
for (Method m : ApplicationComponent.class.getDeclaredMethods()) {
Class[] types = m.getParameterTypes();
if (types.length == 1) {
cache.put(types[0], m);
}
}
return cache;
}

最后,你只要在需要注入依赖的对象(target)中调用getClass(),找到缓存中对应的方法,然后使用invoke()来调用这个方法就行了。

// Use for injecting targets of any type.
void inject(ApplicationComponent component, Object target) {  
Method m = cache.get(target.getClass());
if (m != null) {
m.invoke(component, target);
}
}

在这里,我想重申一下,这个解决方法只是为了省几行代码,却对整个流程进行了过度的设计,我个人来说是不会这样做的,但是对于那些想把注入的过程隐藏在基类中,或者是在旧的代码中已经是这样做的人来说,或许会觉得这个方法是有用的。

Annoyance #2:烦人的地方2:

Component的实现类(比如说:DaggerApplicationComponent)只有在重新编译工程之后才能出现,同时如果在编译时出现任何与注入相关的错误的话,都会提示找不到这个类(换句话说,这个类没有被生成)。

我承认这虽然不是什么大问题,但是你会觉得这有点烦,至少在你刚开始使用Dagger2的那几个小时里会这样觉得,尤其是这几个小时还是你对component改动比较频繁的时候。因而,这个问题还是值得提一下的。

解决方法:据我所知,没有。

Conclusion 结论

我不想在这里长篇大论的总结,所以我会尽可能说的简洁精练

Dagger2是否比原来的版本有明显的进步?是的,提升非常大。

是否还存在问题呢?是的,但是这些问题并没有严重到让你连试都不想试,甚至不会影响到你在生产环境的工程中使用它

Updates 更新

2015-05-11: 根据Jake Wharton的评论,更正了对Dagger 1中反射使用的陈述。

Source 源码

Dagger 2 Demo (GitHub)

Resources 资源

Documentation Video introduction - by Gregory Kick (Google)

 相关推荐

刘强东夫妇:“移民美国”传言被驳斥

京东创始人刘强东和其妻子章泽天最近成为了互联网舆论关注的焦点。有关他们“移民美国”和在美国购买豪宅的传言在互联网上广泛传播。然而,京东官方通过微博发言人发布的消息澄清了这些传言,称这些言论纯属虚假信息和蓄意捏造。

发布于:1年以前  |  808次阅读  |  详细内容 »

博主曝三大运营商,将集体采购百万台华为Mate60系列

日前,据博主“@超能数码君老周”爆料,国内三大运营商中国移动、中国电信和中国联通预计将集体采购百万台规模的华为Mate60系列手机。

发布于:1年以前  |  770次阅读  |  详细内容 »

ASML CEO警告:出口管制不是可行做法,不要“逼迫中国大陆创新”

据报道,荷兰半导体设备公司ASML正看到美国对华遏制政策的负面影响。阿斯麦(ASML)CEO彼得·温宁克在一档电视节目中分享了他对中国大陆问题以及该公司面临的出口管制和保护主义的看法。彼得曾在多个场合表达了他对出口管制以及中荷经济关系的担忧。

发布于:1年以前  |  756次阅读  |  详细内容 »

抖音中长视频App青桃更名抖音精选,字节再发力对抗B站

今年早些时候,抖音悄然上线了一款名为“青桃”的 App,Slogan 为“看见你的热爱”,根据应用介绍可知,“青桃”是一个属于年轻人的兴趣知识视频平台,由抖音官方出品的中长视频关联版本,整体风格有些类似B站。

发布于:1年以前  |  648次阅读  |  详细内容 »

威马CDO:中国每百户家庭仅17户有车

日前,威马汽车首席数据官梅松林转发了一份“世界各国地区拥车率排行榜”,同时,他发文表示:中国汽车普及率低于非洲国家尼日利亚,每百户家庭仅17户有车。意大利世界排名第一,每十户中九户有车。

发布于:1年以前  |  589次阅读  |  详细内容 »

研究发现维生素 C 等抗氧化剂会刺激癌症生长和转移

近日,一项新的研究发现,维生素 C 和 E 等抗氧化剂会激活一种机制,刺激癌症肿瘤中新血管的生长,帮助它们生长和扩散。

发布于:1年以前  |  449次阅读  |  详细内容 »

苹果据称正引入3D打印技术,用以生产智能手表的钢质底盘

据媒体援引消息人士报道,苹果公司正在测试使用3D打印技术来生产其智能手表的钢质底盘。消息传出后,3D系统一度大涨超10%,不过截至周三收盘,该股涨幅回落至2%以内。

发布于:1年以前  |  446次阅读  |  详细内容 »

千万级抖音网红秀才账号被封禁

9月2日,坐拥千万粉丝的网红主播“秀才”账号被封禁,在社交媒体平台上引发热议。平台相关负责人表示,“秀才”账号违反平台相关规定,已封禁。据知情人士透露,秀才近期被举报存在违法行为,这可能是他被封禁的部分原因。据悉,“秀才”年龄39岁,是安徽省亳州市蒙城县人,抖音网红,粉丝数量超1200万。他曾被称为“中老年...

发布于:1年以前  |  445次阅读  |  详细内容 »

亚马逊股东起诉公司和贝索斯,称其在购买卫星发射服务时忽视了 SpaceX

9月3日消息,亚马逊的一些股东,包括持有该公司股票的一家养老基金,日前对亚马逊、其创始人贝索斯和其董事会提起诉讼,指控他们在为 Project Kuiper 卫星星座项目购买发射服务时“违反了信义义务”。

发布于:1年以前  |  444次阅读  |  详细内容 »

苹果上线AppsbyApple网站,以推广自家应用程序

据消息,为推广自家应用,苹果现推出了一个名为“Apps by Apple”的网站,展示了苹果为旗下产品(如 iPhone、iPad、Apple Watch、Mac 和 Apple TV)开发的各种应用程序。

发布于:1年以前  |  442次阅读  |  详细内容 »

特斯拉美国降价引发投资者不满:“这是短期麻醉剂”

特斯拉本周在美国大幅下调Model S和X售价,引发了该公司一些最坚定支持者的不满。知名特斯拉多头、未来基金(Future Fund)管理合伙人加里·布莱克发帖称,降价是一种“短期麻醉剂”,会让潜在客户等待进一步降价。

发布于:1年以前  |  441次阅读  |  详细内容 »

光刻机巨头阿斯麦:拿到许可,继续对华出口

据外媒9月2日报道,荷兰半导体设备制造商阿斯麦称,尽管荷兰政府颁布的半导体设备出口管制新规9月正式生效,但该公司已获得在2023年底以前向中国运送受限制芯片制造机器的许可。

发布于:1年以前  |  437次阅读  |  详细内容 »

马斯克与库克首次隔空合作:为苹果提供卫星服务

近日,根据美国证券交易委员会的文件显示,苹果卫星服务提供商 Globalstar 近期向马斯克旗下的 SpaceX 支付 6400 万美元(约 4.65 亿元人民币)。用于在 2023-2025 年期间,发射卫星,进一步扩展苹果 iPhone 系列的 SOS 卫星服务。

发布于:1年以前  |  430次阅读  |  详细内容 »

𝕏(推特)调整隐私政策,可拿用户发布的信息训练 AI 模型

据报道,马斯克旗下社交平台𝕏(推特)日前调整了隐私政策,允许 𝕏 使用用户发布的信息来训练其人工智能(AI)模型。新的隐私政策将于 9 月 29 日生效。新政策规定,𝕏可能会使用所收集到的平台信息和公开可用的信息,来帮助训练 𝕏 的机器学习或人工智能模型。

发布于:1年以前  |  428次阅读  |  详细内容 »

荣耀CEO谈华为手机回归:替老同事们高兴,对行业也是好事

9月2日,荣耀CEO赵明在采访中谈及华为手机回归时表示,替老同事们高兴,觉得手机行业,由于华为的回归,让竞争充满了更多的可能性和更多的魅力,对行业来说也是件好事。

发布于:1年以前  |  423次阅读  |  详细内容 »

AI操控无人机能力超越人类冠军

《自然》30日发表的一篇论文报道了一个名为Swift的人工智能(AI)系统,该系统驾驶无人机的能力可在真实世界中一对一冠军赛里战胜人类对手。

发布于:1年以前  |  423次阅读  |  详细内容 »

AI生成的蘑菇科普书存在可致命错误

近日,非营利组织纽约真菌学会(NYMS)发出警告,表示亚马逊为代表的电商平台上,充斥着各种AI生成的蘑菇觅食科普书籍,其中存在诸多错误。

发布于:1年以前  |  420次阅读  |  详细内容 »

社交媒体平台𝕏计划收集用户生物识别数据与工作教育经历

社交媒体平台𝕏(原推特)新隐私政策提到:“在您同意的情况下,我们可能出于安全、安保和身份识别目的收集和使用您的生物识别信息。”

发布于:1年以前  |  411次阅读  |  详细内容 »

国产扫地机器人热销欧洲,国产割草机器人抢占欧洲草坪

2023年德国柏林消费电子展上,各大企业都带来了最新的理念和产品,而高端化、本土化的中国产品正在不断吸引欧洲等国际市场的目光。

发布于:1年以前  |  406次阅读  |  详细内容 »

罗永浩吐槽iPhone15和14不会有区别,除了序列号变了

罗永浩日前在直播中吐槽苹果即将推出的 iPhone 新品,具体内容为:“以我对我‘子公司’的了解,我认为 iPhone 15 跟 iPhone 14 不会有什么区别的,除了序(列)号变了,这个‘不要脸’的东西,这个‘臭厨子’。

发布于:1年以前  |  398次阅读  |  详细内容 »
 相关文章
简化Android的UI开发 5年以前  |  521240次阅读
Android 深色模式适配原理分析 4年以前  |  29632次阅读
Android阴影实现的几种方案 2年以前  |  12220次阅读
Android 样式系统 | 主题背景覆盖 4年以前  |  10293次阅读
 目录