Dagger2之@Inject注解

本文将尝试列出@Inject注解的各种用法。后面的一系列文章都会对Dagger2的用法进行各个点逐一击破,以便更好的理解Dagger2。

请注意,本文将省略启动注入过程的方法的调用,即本文是不完整的用法,我们仅仅会看到@Inject的使用点而忽略掉其他一些必要的调用。

使用@Inject注解变量

这个是使用Dagger过程中必须出现的写法。因为注解了@Inject的变量表示该变量要求Dagger为其注入值。对于没有注解@Inject的变量,Dagger是不会为其注入值的。下面是@Inject注解变量的写法:

@Inject
public String str;

这样写表示变量str请求Dagger为其注入一个String值。该值可能从注解了@Inject的构造方法获取(这个我们下面会用到),也可能从注解了@Provides的方法的返回值获取(这个我们可以从前面的Dagger2 Android入门一文中看到相关用法)。

需要注意的是使用@Inject注解的变量不能是private变量,否则会报以下错误:

Error:(13, 20) 错误: Dagger does not support injection into private fields

原因是Dagger2是采用编译时产生注入代码(一个注入工具类)来为变量注入值,注入过程如下所示:

public void injectMembers(MainActivity instance) {  
    if (instance == null) {
      throw new NullPointerException("Cannot inject members into a null reference");
    }
    supertypeInjector.injectMembers(instance);
    instance.str = strProvider.get();//为变量str注入值,若变量str为private,此处就无法引用到str
}

使用@Inject注解构造方法

使用@Inject注解构造方法的写法之一如下所示:

public class StringGetter {

    @Inject
    StringGetter(){}
}

这种写法表示StringGetter类将为注解了@Inject的StringGetter对象注入无参构造方法构造的对象。如果同一个项目下其他类有下面的写法,那么Dagger将会为其构造一个对象并注入:

public class MainActivity extends Activity {
    @Inject
    StringGetter getter;//Dagger会调用StringGetter的无参构造方法创建对象并赋值给此处的getter

    ...
}

对于有参构造方法,如下所示:

public class StringGetter {

    @Inject
    StringGetter(OtherGetter getter){
        ...
    }
}

则Dagger会自动为所有构造参数注入值,参数值的来源则与@Inject注解变量的值的来源一样。最后要注意的一点就是,在@Inject注解的变量或者有参构造方法的参数没有值提供方的情况下,其值会为null,大家需要注意这个问题。

你可能感兴趣的:(Android)