4..基于Dagger2.38.1版本源码理解hilt注解-其他注解和测试注解

前言 测试注解 bindValue

@BindValue、@BindValueIntoSet、@BindElementsIntoSet或@BindValueIntoMap用于测试环境。

@BindValue、@BindValueIntoSet、@BindElementsIntoSet或@BindValueIntoMap修饰的bindValue节点变量校验规则如下：

1. @BindValue、@BindValueIntoSet、@BindElementsIntoSet或@BindValueIntoMap同一个变量上只能被其中一个修饰；

2. bindValue节点只能是变量；

3. bindValue节点所在父节点如果是类或接口，并且是kotlin文件，那么bindValue节点的getter方法不能使用private修饰；表示kotlin文件，那么当前bindValue变量不能使用private修饰；

4. bindValue变量不能使用@Inject注解修饰；

5. bindValue变量上最多只能使用一个@Qualifier修饰的注解修饰；

6. bindValue变量如果使用了@BindValueIntoMap修饰，那么必须和@MapKey修饰的注解必须同时使用，并且@MapKey修饰的注解只允许出现一次；

7. bindValue变量不允许使用@Scope修饰的注解修饰；

8. bindValue变量所在类必须使用@HiltAndroidTest注解修饰;

9. bindValue变量如果使用@BindElementsIntoSet修饰则当前变量必须是Set< T> - 源码中没有体现，这条是根据@ElementsIntoSet规则推理出来的。

demo：

@HiltAndroidTest
public class FooTest{
	
	@BindValue
	Bar bar;

	@BindValueIntoSet
	BarIntoSet barIntoSet;

	@BindElementsIntoSet
	Set barElementsIntoSet;

	@BindValueIntoMap
	@ClassKey(Foo.class)
	BarIntoMap barIntoMap;
}

生成的代码：

  @Module
  @OriginatingElement(topLevelClass = FooTest.class)
  @InstallIn(SingletonComponent.class)
  @Generated("BindValueGenerator")
  public final class FooTest_BindValueModule {
     
 	 @Provides
     static FooTest providesFooTest(@ApplicationContext Context context) {
       return (FooTest)
           ((TestApplicationComponentManager)
               ((TestApplicationComponentManagerHolder) context).componentManager())
                   .getTestInstance();
     }
	
	 @Provides
     static Bar providesBar(FooTest test) {
       return test.bar;
     }

	 @IntoSet
	 @Provides
     static BarIntoSet providesBarIntoSet(FooTest test) {
       return test.barIntoSet;
     }

	 @ElementsIntoSet
	 @Provides
     static Set providesSet(FooTest test) {
       return test.barElementsIntoSet;
     }

	 @IntoMap
	 @ClassKey(Foo.class)
	 @Provides
     static BarIntoMap providesBarIntoMap(FooTest test) {
       return test.barIntoMap;
     }
  }

@CustomTestApplication注解

规则如下：

1. @CustomTestApplication修饰节点必须是类或接口；

2. @CustomTestApplication注解中的value值类型（及其深层次遍历到的类型）不能使用@HiltAndroidApp修饰；

3. @CustomTestApplication注解中的value值类型（及其深层次遍历到的类型）不能存在@Inject修饰的变量或普通方法或构造函数；

4. @CustomTestApplication注解中的value值类型必须存在并且是Application或其子类。

demo：

@CustomTestApplication(BaseApplication.class)
class CustomTestApplication{}

生成代码如下：

@Generated("CustomTestApplicationProcessor")
public final class CustomTestApplication_Application extends BaseApplication interface GeneratedComponentManager