Dagger2 生成代码学习

　　接上一篇文章介绍了Dagger2的初步使用，相信刚接触的人会觉得很奇怪，怎么会有很多自己没有定义的代码出现，为什么Component的创建方式是那样的。为了搞清楚这些东西，我们需要查看一下Dagger2 生成的源代码。Dagger2 是一个DI框架，通过学习生成的代码也可以更好的理解Dagger2是如何做依赖注入的。

　　将上一篇文章中的工程在SublimeText中打开，结构如下图：



　　可以看到AppComponent 生成了 DaggerAppComponent，Dagger2的生成规则中，我们自定义的Component生成之后会加上前缀“Dagger”。此外Module中的每个@Provides 方法都会生成一个Factory 类，命名规则也是很规律的。这里Dagger一共为我们生成了6个类：DaggerAppComponent / AppModule_ProvideApplicationFactory /ReposListActivity_MembersInjector / GithubApiModule_ProvideRetrofitFactory / GithubApiModule_ProvideOkHttpClientFactory / GithubApiModule_ProvideGitHubServiceFactory。接下来我们看看这些类具体是什么样的。

　　首先来看一下DaggerAppComponent:

@Generated("dagger.internal.codegen.ComponentProcessor")
public final class DaggerAppComponent implements AppComponent {
private Provider<Application> provideApplicationProvider;
private Provider<OkHttpClient> provideOkHttpClientProvider;
private Provider<Retrofit> provideRetrofitProvider;
private Provider<GithubApiService> provideGitHubServiceProvider;
private MembersInjector<ReposListActivity> reposListActivityMembersInjector;

private DaggerAppComponent(Builder builder) {
assert builder != null;
initialize(builder);
}

public static Builder builder() {
return new Builder();
}

private void initialize(final Builder builder) {
this.provideApplicationProvider = AppModule_ProvideApplicationFactory.create(builder.appModule);
this.provideOkHttpClientProvider = GithubApiModule_ProvideOkHttpClientFactory.create(builder.githubApiModule);
this.provideRetrofitProvider = GithubApiModule_ProvideRetrofitFactory.create(builder.githubApiModule, provideApplicationProvider, provideOkHttpClientProvider);
this.provideGitHubServiceProvider = GithubApiModule_ProvideGitHubServiceFactory.create(builder.githubApiModule, provideRetrofitProvider);
this.reposListActivityMembersInjector = ReposListActivity_MembersInjector.create((MembersInjector) MembersInjectors.noOp(), provideGitHubServiceProvider);
}

@Override
public void inject(ReposListActivity activity) {
reposListActivityMembersInjector.injectMembers(activity);
}

public static final class Builder {
private AppModule appModule;
private GithubApiModule githubApiModule;

private Builder() {
}

public AppComponent build() {
if (appModule == null) {
throw new IllegalStateException("appModule must be set");
}
if (githubApiModule == null) {
this.githubApiModule = new GithubApiModule();
}
return new DaggerAppComponent(this);
}

public Builder appModule(AppModule appModule) {
if (appModule == null) {
throw new NullPointerException("appModule");
}
this.appModule = appModule;
return this;
}

public Builder githubApiModule(GithubApiModule githubApiModule) {
if (githubApiModule == null) {
throw new NullPointerException("githubApiModule");
}
this.githubApiModule = githubApiModule;
return this;
}
}
}

　　我们在Application中实例化AppComponent的时候是这样的：

appComponent = DaggerAppComponent.builder()
.githubApiModule(new GithubApiModule())
.appModule(new AppModule(this))
.build();

　　第一次见的时候肯定觉得一团雾水，为什么要这样写呢？ 通过上面DaggerAppcomponent代码可以看出，使用了建造者模式。我们回顾一下AppComponent是怎么样的：

@Component(modules = { AppModule.class, GithubApiModule.class})
public interface AppComponent {
// inject what
void inject(ReposListActivity activity);
}

　　@component 后面modules包含了两个类，在生成的DaggerAppComponent 中的内部类 Builder中，AppModule.class 和 GithubApiModule.class 成为了其成员，并且提供了set方法。在Application中实例化DaggerAppComponent的过程中其实就是调用了其set方法来设置依赖。此外在DaggerAppComponent各个@Provides 注解的方法返回类型都是其一个成员变量，并在Initialize()方法中创建。此外还有一个MembersInjector成员，DaggerAppComponent也要负责创建它。

@Generated("dagger.internal.codegen.ComponentProcessor")
public final class ReposListActivity_MembersInjector implements MembersInjector<ReposListActivity> {
private final MembersInjector<BaseActivity> supertypeInjector;
private final Provider<GithubApiService> githubApiServiceProvider;

public ReposListActivity_MembersInjector(MembersInjector<BaseActivity> supertypeInjector, Provider<GithubApiService> githubApiServiceProvider) {
assert supertypeInjector != null;
this.supertypeInjector = supertypeInjector;
assert githubApiServiceProvider != null;
this.githubApiServiceProvider = githubApiServiceProvider;
}

@Override
public void injectMembers(ReposListActivity instance) {
if (instance == null) {
throw new NullPointerException("Cannot inject members into a null reference");
}
supertypeInjector.injectMembers(instance);
instance.githubApiService = githubApiServiceProvider.get();
}

public static MembersInjector<ReposListActivity> create(MembersInjector<BaseActivity> supertypeInjector, Provider<GithubApiService> githubApiServiceProvider) {
return new ReposListActivity_MembersInjector(supertypeInjector, githubApiServiceProvider);
}
}

　　ReposListActivity_MembersInjector 中通过 injectMembers 方法获取到 ReposListActivity 的实例（对应的就是 ReposListActivityComponent中的inject），然后进行赋值。从这种赋值的方式来看被@Inject注解的注入对象不能是private的。在看赋值是通过 githubAPiServiceProvider.get() 方法获取的，githubApiServiceProvider是一个工厂类，我们来看看这个工厂类是怎么样的：

@Generated("dagger.internal.codegen.ComponentProcessor")
public final class GithubApiModule_ProvideGitHubServiceFactory implements Factory<GithubApiService> {
private final GithubApiModule module;
private final Provider<Retrofit> retrofitProvider;

public GithubApiModule_ProvideGitHubServiceFactory(GithubApiModule module, Provider<Retrofit> retrofitProvider) {
assert module != null;
this.module = module;
assert retrofitProvider != null;
this.retrofitProvider = retrofitProvider;
}。

@Override
public GithubApiService get() {
GithubApiService provided = module.provideGitHubService(retrofitProvider.get());
if (provided == null) {
throw new NullPointerException("Cannot return null from a non-@Nullable @Provides method");
}
return provided;
}

public static Factory<GithubApiService> create(GithubApiModule module, Provider<Retrofit> retrofitProvider) {
return new GithubApiModule_ProvideGitHubServiceFactory(module, retrofitProvider);
}
}

　　GithubApiModule_ProvideGitHubServiceFactory 类中有两个成员，一个是提供（@Provides）GithubService 所在的 module 类，一个是创建GithubService方法所需参数的retrofitProvider（从这里可以看出Dagger2需要创建retrofitProvider的工厂）。然后通过 module.provdeGitHubService()方法来创建 GithubApiService实例，这样最终穿件了在ReposListActivity中注入的依赖实例。

　　Dagger2 入门有点绕，也没找到什么系统性的资料，但是可以通过查看框架自动生成的类来加深理解，方便大家使用。使用到dependencies和SubComponent注解的时候生成的代码就比较多了，本来也想捋捋的，但是原理和上面的都是一样的，大家自己去看吧。