Dagger 2 原理和使用

于 2025-06-09 17:55:45 发布
阅读量688 收藏 26
点赞数 29
CC 4.0 BY-SA版权
分类专栏： 架构 android 三方库 文章标签： java android di
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/wulong756273/article/details/148539673

Dagger 2 是一个基于 编译时依赖注入 的框架，其核心原理可以概括为以下几个关键点：

原理

1. 核心目标：解耦与自动化依赖管理

  • 依赖注入 (DI)：将对象的创建与其使用分离。类声明它需要什么依赖（如通过构造函数参数、字段标记），外部框架负责提供这些依赖实例。

  • 解耦：使用者不关心依赖如何创建，只关心接口/类型。

  • 可测试性：依赖可轻松替换为模拟对象。

2. 核心机制：编译时注解处理

  • APT (Annotation Processing Tool)：

    • Dagger 2 在编译时扫描源代码中的注解（如 @Inject, @Module, @Provides, @Component）。

    • 生成可读的 Java 源码（在 build/generated/source/apt 目录下），而非使用反射（这是运行时 DI 框架的特点）。

  • 优势：

    • 高性能：运行时无反射开销。

    • 编译时错误检查：依赖关系不满足（如缺少绑定、循环依赖）会在编译时报错，而非运行时崩溃。

    • 可追溯性：生成的代码可阅读，便于调试。

3. 核心组件及其协作

  • @Inject：

    • 标记依赖需求：在构造函数、字段或方法上使用，表示“我需要这个依赖”。

    • 标记依赖提供者：在类的构造函数上使用，表示“我可以提供自身实例”。

  • @Module 与 @Provides：

    • @Module：标记类，作为依赖提供的“模块”。包含无法用 @Inject 构造的依赖（如接口、第三方库对象）。

    • @Provides：标记模块中的方法，该方法返回一个依赖实例（如 provideHttpClient()）。

  • @Component：

    • 核心桥梁：标记接口/抽象类，连接 Modules（提供依赖）和 注入目标（使用依赖）。

    • 职责：

      • 组合相关 Module(s)。

      • 定义注入目标（如 inject(MainActivity activity)）。

      • 暴露特定依赖给其他 Component（通过接口方法）。

    • Dagger 生成实现类：如 DaggerAppComponent，包含完整的依赖图解析逻辑。

  • @Singleton / Scope 注解：

    • 控制生命周期：标记依赖在指定范围内（如全局 App、Activity）保持单例。

    • 实现原理：通过 Component 内部缓存实例（如 DoubleCheck 包装的 Provider），而非传统全局静态变量。

4. 依赖解析流程（以注入 Activity 为例）

  1. 声明注入点：在 Activity 中标记 @Inject 字段。

  2. 创建 Component：构建 Dagger 生成的 Component 实现（如 DaggerAppComponent.create()）。

  3. 触发注入：调用 component.inject(this)。

  4. 依赖图解析：

    • Component 查找 Activity 所需依赖的类型。

    • 按优先级查找绑定：

      • 检查 Module 中的 @Provides 方法。

      • 检查 @Inject 构造函数的类。

      • 检查父 Component 暴露的依赖（若涉及层级）。

    • 自动递归：解析依赖的依赖，直至所有叶子节点（无依赖的基础类型或已绑定类型）。

  5. 注入实例：将解析好的依赖实例赋值到 Activity 的 @Inject 字段。

5. 关键高级特性原理

  • Subcomponents vs. Component Dependencies：

    • Subcomponent：继承父 Component 的所有绑定，可访问父的依赖。生命周期更短（如 @ActivityScope）。通过父 Component 的工厂方法创建。

    • Component Dependencies：通过接口显式暴露依赖，松耦合但需手动声明。

  • Qualifiers (@Named, @Qualifier)：区分相同类型的不同实例（如 @Named("apiUrl") String url）。

  • Multibindings：将多个绑定聚合到一个集合（如 Map<Class, Provider>），用于插件式架构。

  • Lazy / Provider：

    • Lazy<T>：延迟初始化，首次 get() 时创建。

    • Provider<T>：每次 get() 返回新实例或重新获取。

使用

一、复杂依赖管理场景

当对象依赖层级深、创建逻辑复杂时，手动管理依赖会导致代码冗余且易错。Dagger2 通过自动生成依赖注入代码，显著简化此类场景：

  1. 多层级依赖
    例如：CoffeeMachine 依赖 CoffeeMaker，CoffeeMaker 又依赖 Cooker。
    传统方式需嵌套 new 调用：
    new CoffeeMachine(new CoffeeMaker(new Cooker()))
    Dagger2 通过 @Inject 构造函数 + @Component 自动解析依赖链，无需显式创建对象36。

  2. 第三方库或接口注入
    无法修改源码的类（如 Retrofit、Room 等），可通过 @Module + @Provides 提供实例：

    @Module
public class ApiModule {
    @Provides
    Retrofit provideRetrofit() {
        return new Retrofit.Builder().baseUrl(BASE_URL).build();
    }
}

 二、模块化开发场景

大型项目需按功能拆分为独立模块，Dagger2 支持组件化依赖管理：

  1. 子组件（Subcomponent）
    实现作用域隔离（如全局 AppComponent → 页面级 ActivityComponent），子组件继承父组件的依赖，避免重复创建单例。

  2. 组件依赖（Component Dependencies）
    松耦合的模块间通信，例如 UserComponent 依赖 AppComponent 获取全局数据库实例。

 三、测试优化场景

依赖注入天然支持替换实现，提升单元测试效率：

  1. Mock 依赖注入
    测试时替换 @Module 的实现，例如将网络模块替换为本地模拟数据源：

    @Module
public class TestNetworkModule {
    @Provides
    ApiService provideFakeApiService() {
        return new MockApiService(); // 模拟网络请求
    }
}

  2. 环境差异化配置
    Debug 与 Release 环境使用不同 Module（如日志开关、API 地址）。

四、Android 特定场景

Dagger2 在 Android 开发中尤其高效，解决平台特有痛点：

  1. 生命周期绑定
    通过 dagger.android 库自动注入 Activity/Fragment，避免手动调用 component.inject(this)。

  2. 作用域管理
    使用 @Singleton（应用级）、@PerActivity（页面级）等自定义作用域，控制实例生命周期（如单例在应用退出时才销毁）。

  3. 资源解耦
    Context、SharedPreferences 等系统服务通过 Module 统一提供，避免在业务类中硬编码。

五、性能敏感场景

相比反射型框架（如 Guice），Dagger2 的编译时代码生成带来显著性能优势：

  • 无运行时反射开销：生成的代码效率与手写相当26。

  • 编译时验证：依赖缺失或循环依赖在编译期报错，避免运行时崩溃48。

六、作用域管理场景

通过作用域注解控制对象复用策略，适应不同需求：

场景实现方式示例
全局单例@Singleton数据库实例、全局配置
延迟初始化Lazy<T>耗时对象首次访问时才创建
每次获取新实例Provider<T>每次请求生成新对象
页面级单例@PerActivityPresenter 绑定 Activity 生命周期

总结：Dagger2 适用场景对比

场景类型核心需求Dagger2 方案优势
多层级依赖简化对象创建流程@Inject + @Component消除嵌套 new，自动解析依赖链
模块化开发组件间解耦Subcomponent/依赖组件作用域隔离，依赖复用
单元测试快速替换依赖实现测试专用 Module无需修改生产代码
Android 平台生命周期绑定dagger.android 扩展库减少模板代码
高性能要求避免运行时开销编译时代码生成接近手写性能

💡 实际项目建议：

  • 中小项目：从关键页面（如登录模块）逐步引入，避免过度设计。

  • 大型应用：结合 Clean Architecture 或 MVP/MVVM，使用 Dagger2 管理全局 Repository、DataSource 等。

  • 替代方案考量：若项目依赖简单，可评估是否需引入 Dagger2，避免增加学习成本。

第三方库与工具：依赖注入框架Hilt与Dagger2原理剖析
Ya-Jun 的博客
03-16 248
依赖注入是指将一个对象所依赖的其他对象（依赖项）传递给它，而不是由这个对象自己创建其依赖项。降低类之间的耦合度提高代码的可测试性方便管理对象的生命周期简化代码维护依赖注入的基本概念和优势Dagger2和Hilt的核心原理源码级别的实现机制实际项目中的应用方案测试和多模块项目的配置方法优先使用Hilt，除非有特殊需求合理使用作用域，避免内存泄漏遵循依赖注入的最佳实践重视测试的可维护性。
Android中Dagger的使用(一)
最新发布
small_bird_top的博客
11-15 1826
目录 一:引入依赖 二:Dagger详细使用 1.构造方法创建对象 2.非构造方法创建对象 3.Dagger注解的使用 1.Singleton 一:局部单例 二:全局单例 三.Singleton的使用须知 2.组件依赖 一:普通方式的组件依赖 Module声明: Component声明: 实际使用: 二:利用Subcomponent注解实现组件依赖 1. 子组件声明 2.子组件Module声明 3.使用 4.Module需要传参时 1. Module的
Dagger2 的使用与基本原理
tmacfrank
10-30 1692
使用 Dagger2 的最佳做法：如果有可能，通过@Inject进行构造函数注入，以向 Dagger 图中添加类型。使用@Binds告知 Dagger 接口应采用哪种实现使用@Provides告知 Dagger 如何提供你的项目所不具备的类只能在组件中声明一次模块根据注释的使用生命周期，为作用域注释命名，例如和依赖注入。
Dagger具体使用
11-04
Dagger2具体使用实例，各种注解的运用，博客中也有介绍
「神兵利器Dagger2 | 掘金技术征文 」
weixin_33888907的博客
12-19 229
Dagger-匕首，鼎鼎大名的Square公司旗下又一把利刃（没错！还有一把黄油刀，唤作ButterKnife）；故此给本篇取名神兵利器Dagger2。 Dagger2起源于Dagger，是一款基于Java注解来实现的完全在编译阶段完成依赖注入的开源库，主要用于模块间解耦、提高代码的健壮性和可维护性。Dagger2在编译阶段通过apt利用Java注解自动生成Java代码，然后结合手写的代码来自动帮...
Dagger 使用
王人冉的博客
06-30 395
https://www.jianshu.com/p/2cd491f0da01 Android - Dagger2使用详解
Dagger的使用一
Mr_Tony的专栏
05-01 564
文章目录一、前言二、添加依赖三、简单示例四、作用域五、自定义作用域六、@Binds 和 @Provides七、关于Dagger为什么在Android中要比Hilt复杂八、inject(Activity act)的用法十、参考链接 一、前言 Hilt是对Dagger的封装处理，这里对其进行下简单介绍。 二、添加依赖 implementation 'com.google.dagger:dagger:2.41' kapt 'com.google.dagger:dagger-compiler:2.4
dagger的简单使用
glc11223344的博客
05-14 703
前言 虽然有了更好的hilt框架，但是许多老项目中还有在使用dagger 下面就来简单了解一下吧。 添加依赖 上面的是dagger的依赖 //dagger相关依赖 implementation 'com.google.dagger:dagger:2.7' annotationProcessor 'com.google.dagger:dagger-compiler:2.7' //retrofit相关依赖 implementation 'com.squareup.retro
Dagger2新手入门与使用基础教程
01-20
Dagger2的原理是通过编译时生成的代码，根据Component和Module的定义，构建出依赖树，然后在运行时根据这个树来实例化和注入对象。虽然初学者可能会感觉学习曲线较陡峭，但一旦掌握，Dagger2能极大地提高代码的可...
android Dagger2局部单例使用
08-10
Dagger2是Google推出的一个强大的依赖注入框架，适用于Java和Kotlin项目。本篇文章将深入探讨如何在Android应用中使用Dagger2实现局部单例。 首先，我们要理解什么是局部单例。单例模式是一种常见的设计模式，确保...
dagger2-demo
06-10
Dagger2使用注解来声明类的依赖关系以及提供者。 3. **@Component注解**：用于定义一个依赖图，即哪些类会相互依赖。Component接口声明了可以构建的对象和它们的依赖关系。 4. **@Module注解**：Module类用于提供...
Dagger 使用入门
wangzp的博客
11-16 3149
Dagger ，一款让我们能省去无用代码的依赖注入框架！
Dagger-Android使用
my优快云1997的博客
12-03 624
Dagger-Android的使用 官方文档 参考blog 必须注意:void inject()注入中的参数必须是具体的子类而不是父类,具体见第3步中的void inject(App app)。 添加依赖，根据文档即可； 编写具体要实现组件(例如Activity)的Subcomponent和Module,Module中可以编写对应组件需要的依赖方法,比如static Xxx provideXxx...
Dagger 2
s127838498的专栏
11-23 478
网上看了很多这方面的博客，对它的概念也有了大体上的了解，感觉大部分的文章把Dagger的使用写的太乱了，于是打算参考下官网，一下是一些记录： Why Dagger 2 is Different 各种不同类型的DI框架已经存在了好多年，为什么要重写造轮子呢，官网上是这样说的：Dagger 2 is the first to implement the full stack with generate...
dagger2
ms
02-11 196
Dagger2是什么？ Dagger2是一个通过Java注解的手段，省下大量new对象的代码，并达成解耦目的的框架。也就是老生常谈的依赖注入框架。 @Inject: 通常在需要依赖的地方使用这个注解。换句话说，你用它告诉Dagger这个类或者字段需要依赖注入。这样，Dagger就会构造一个这个类的实例并满足他们的依赖。 @Module: Modules类里面的方法专门提供依赖，所以我们定义一个...
最简单的Dagger2入门教程
热门推荐
茅屋
07-18 2万+
在上一篇博客中总结了依赖注入的原理与实现方式。 依赖注入的原理 依赖注入就是将调用者需要的另一个对象实例不在调用者内部实现，而是通过一定的方式从外部传入实例，解决了各个类之间的耦合。那么这个外部，到底指的是哪里，如果指的是另一个类，那么，另一个类内部不就耦合了。能不能有一种方式，将这些构造的对象放到一个容器中，具体需要哪个实例时，就从这个容器中取就行了。那么，类的实例和使用就不在有联系了，而是通过一
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值