引言
在程序中, 最重要的类是那些真正实现功能
的类:比如BarcodeDecoder
(条形码解码器),KoopaPhysicsEngine
(某某引擎),249)">AudioStreamer(音频流)。这些类往往有些依赖类, 比如BarcodeCameraFinder
(条形码图形识别器),249)">DefaultPhysicsEngine(默认物理引擎),和HttpStreamer
(http输出流).
相反, 程序中最不重要的类是辅助类(take up space without doing much at all): BarcodeDecoderFactory(条形码解析器工厂),CameraServiceLoader(相机服务加载器),和 MutableContextWrapper(易变环境变量包装器).这些辅助类就像笨拙的胶带一样,将那些重要的功能类连接起来。
Dagger 就是这些工厂类的终结者。 它帮助你专注在那些重要的功能类上。通过声明依赖关系, 指定规则, 构建整个应用程序。
Dagger 构建在标准的javax.injectannotation基础之上,每一个类都很容易测试。你也不需要为了便于将 RpcCreditCardService 替换为 FakeCreditCardService, 而构建一堆的样板(boilerplate)。
依赖注入
(Dependency injection
)也并不是仅仅为了测试。 它可以使很容易创建 可复用、通用的Module
。在整个应用程序中, 你可以共享同一个AuthenticationModule
。你也可以在开发过程中使用DevLoggingModule
,而在发布时使用ProdLoggingModule
。
更多信息请移步watch an introductory talk by Jesse Wilson at QCon 2012.
译者:
上文中有两个概念:
1. 依赖注入, Dependency injection. 也叫控制反转(IoC), 就是通过一定的规则管理对象间的依赖关系。详细概念参考wiki控制反转
2. 而Dagger组件则通过annotation实现了依赖注入。
Using Dagger
接下来, 我们通过构建一个Coffer Maker 来说明 依赖注入 和 Dagger。你可以下载完整的Coffee Maker示例代码, 编译调试。
声明依赖关系
Dagger 构造应用程序的类对象,并组合其依赖关系。 Dagger使用javax.inject.Inject
annotation 标记那些构造函数和成员变量需要依赖注入。
Dagger将使用@Inject 注释的构造函数
创建类对象。 当请求构建新的类对象时, Dagger 将自动获取相应的参数, 并调用构造函数。
class Thermosiphon implements Pump { private final Heater heater; @Inject Thermosiphon() { this.heater = ; } ... }
Dagger 可以直接注入成员变量。在这个例子中, 它获取Heater对象, 并注入到成员变量heater,同时获取Pump对象并注入到成员变量pump。
译者:
若是某些类不需要Inject任何对象, 而又希望由Dagger创建该类对象。 这时, 应该至少添加一个@Inject的默认构造函数, 否则会报异常。
实现依赖关系
(Satisfying Dependencies, 实在想不出合适的中文对应)
默认情况下, Dagger 通过构造相应类型的对象来实现依赖关系。当请求一个CoffeMaker对象时, Dagger将调用new CoffeeMaker()构造函数, 并赋值给@Inject标记的成员变量。
但是@Inject并不是在任何情况下都可以:
- 接口类型不能被构造
- 第三方的类不能被注释构造。
- 可配置的对象必须被配置好 @H_502_149@
译者:
第一条是说, interfaces的注入Dagger是不能直接构造对象的。当然这样了, 给你接口,谁也构造不了对象。
第二条是说,Third-party classes can't be annotated. Dagger只能构造那些有@Inject注释的类, 即便没有@Inject 成员变量, 也要至少有一个@Inject的构造函数。第三方的类显然不能加入@Inject注释, 因此也不能被Dagger构造.
第三条是 Configurable objects must be configured!,不明白啥意思, 求大神指教。
对那些使用@Inject效率极低或者awkward的情况, 可以使用@Provides注释函数来实现依赖关系。这些函数的返回类型定义其实现的依赖关系。
例如, 当需要一个Heater时, Dagger将调用provideHeater()函数获取。
构建ObjectGraph(对象图表)
@Inject 和 @Provides 注释的类构建了一个对象图表。这些对象与对象之间通过依赖关系相互关联。通过函数ObjectGraph.create()
获取这个对象图表,这个函数可以接受一个或多个Module作为参数:
我们需要引导注入来使用这个对象图表。 对于命令行程序, 通常需要注入一个主程序类;对于Android程序,通常需要注入activity类。在这个coffer例子中, CoffeeApp被用于引导注入。我们请求这个对象图表构建一个CoffeeApp的对象实例:
现在, 对象图表已经构建好, 根对象也已被注入, 我们就可以运行这个Coffee 程序了。
$ java -cp ... coffee.CoffeeApp ~ ~ ~ heating ~ ~ ~ => => pumping => => [_]P coffee! [_]P